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EXTENSIBLE INFORMATION SYSTEM 

A portion of the disclosure of this patent document contains material, which is 
subject to copyright protection. The copyright owner has no objection to the facsimile 
5 reproduction by anyone of the patent document or the patent disclosure, as it appears 
in the Patent and Trademark Office patent file or records, but otherwise reserves all 
copyright rights whatsoever. 

This application claims priority of co-pending U.S. Provisional Patent 
10 Application Serial No. 60/242,041 entitled "Extensible Information System (XIS)" by 
R. Kadel et al., filed October 20, 2000. Priority of the filing date of October 20, 2000 
is hereby claimed, and the disclosure of said Provisional Patent Application is hereby 
incorporated by reference. 

15 BACKGROUND 



1. Field Of The Invention 

The present invention relates generally to data processing systems and, more 
20 particularly, to systems that process, analyze, and display data or information. 

2. Description of the Related Art 

The continuing inroads made by computer technology into the practices of 
25 information storage and manipulation have opened up new realms of possibility for 
intelligent, informed decision-making. From labor statistics and scientific databases 
like the human genome project to traffic patterns and aircraft positions, the 
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availability of information in electronic form allows sophisticated analysis techniques 
and display methods to be applied at the touch of a button. However this diverse 
array of information also poses significant challenges in areas such as: 



This task of information management has already grown beyond the ability of 
human operators to keep pace with it, and in most applications, there is far more 
relevant information electronically available on the web and elsewhere than is 
effectively used. The problem is that software affording display of and interaction 

15 with information must be custom-designed for the particular type and format of the 
information it will work with. This leads to high costs of software development and 
limited availability of software appropriate to information of interest, and poor 
integration between information from different sources. An analyst must use one 
program when dealing with geographic distribution data such as precipitation amounts 

20 or land use, another for rendering 3 -dimensional terrain, another for examining 

congressional districts and voting records, and so on. Many desirable applications of 
available data, such as determining correlations between political party and land use 
strategy in this case, fall between the cracks left by specialized applications, and there 
is no easy way to allow them to intemperate. 

25 The primary means for allowing one application to operate on the results of 

another are the limited cut and paste facilities offered by many operating systems, 
which allow plain or formatted text or images to be moved between programs. There 



10 



5 



effective organization of information; 

ability to interpret and manipulate information in an increasingly 
wide variety of formats so that data and processing software can 
be brought together in a compatible but also timely and effective 
way; and 

recognizing and navigating relationships between disparate 
information types. 
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is no independent way to transfer structured data such as a table of numbers with 
particular column headings, a set of lists of items under specified categories, or even 
something as simple as a single number with an associated unit of measurement. 
From the discussion above, it should be apparent that there is a need for 
5 computer systems that have greater ability to develop, integrate, and interoperate with 
disparate sources of information, to more easily develop software applications, 
components, or objects, and to facilitate interoperation of data between software 
components. The present invention fulfills this need. 

10 SUMMARY OF THE INVENTION 

In accordance with the present invention, a framework for use with object 
oriented programming (OOP) systems provides a framework user with classes that 
comprise a mediation layer that defines an interface between data source components 

15 and data consumer components such that the configuration of the data source 

components can be specified independently of the data consumer components. The 
mediation layer specifies data relationships of the data objects, domain methods for 
defining groups of class attributes, attribute metadata for defining groups of class 
attributes, and change event registration for detecting changes in data values. Thus, 

20 when extended, the mediation layer of the framework can support runtime data 
manipulation between unrelated data source components and data consumer 
components. In this way, the framework provides an extensible information system. 
The framework will be referred to herein as "XIS", and is especially suited to assist in 
the development of information-handling systems or applications. 

25 Data source components that are configured for a non-XIS-aware 

programming environment or framework may still be used with XIS by "wrapping" 
such source components with code to conform to the interface requirements. Data 
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objects of the well-known "Java" programming language are examples of data source 
components. Data consumer components thus are able to use or consume various data 
source components regardless of the data types and the data source. Thus, once a data 
consumer component is developed within the XIS framework, any data source 

5 components within the XIS framework may also accordingly be used. The 

framework can be provided as a group of APIs (application programming interface). 

The XIS framework of the present invention also includes libraries and APIs 
that provide information management technologies that enable developers and 
integrators to combine XlS-aware components, data sources, and off-the-shelf 

10 JavaBeans into complete systems designed around whatever architecture is best for 

the situation. XIS further supports multiple, dynamic domains and is scalable to n-tier 
systems using the latest technology. The framework enables many developers to 
choose architectures based on their requirements (e.g., server, client/server, 
application server, web server, standalone, hand-held, etc.). 

15 Other features and advantages of the present invention should be apparent from 

the following description, which illustrates, by way of example, the principles of the 
invention. 



BRIEF DESCRIPTIONS OF THE FIGURES 

20 

Figure 1 is a diagram of the extensible information system (XIS) framework 
constructed in accordance with the present invention. 

Figure 2 is a more detailed diagram of Figure 1, showing the various interfaces 
within XIS, constructed in accordance with the present invention. 
25 Figure 3 A is a more detailed diagram of Figure 1, including information and 

services available within XIS, constructed in accordance with the present invention. 
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Figure 3B is a hierarchical structure diagram of ati embodiment of an 
InfoModel constructed in accordance with the present invention. 

Figure 4 is a more detailed diagram of Figure 1 showing various information 
available to components within XIS constructed in accordance with the present 
5 invention. 

Figure 5 is a diagram of the semantic representation of a data item within the 
XIS framework constructed in accordance with the present invention. 

Figures 6A to 6F show data consumer components, particularly display 
components, constructed in accordance with the present invention. 
10 Figure 7 shows a consumer component displaying the properties exposed by a 

data source object constructed in accordance with the present invention. 

Figure 8 is a unified modeling language (UML) diagram of a Person object. 

Figure 9 lists a set of attributes exposed within the XIS framework by the 
Person object of Figure 6 constructed in accordance with the present invention. 
15 Figure 10 illustrates that an object constructed in accordance with the present 

invention may subscribe to more than one domain policy or definition. 

Figure 1 1 shows a domain usage and sequence scenario between a consumer 
component and source component constructed in accordance with the present 
invention. 

20 Figures 12 A to 12D list information regarding a Type Metadata package class 

typically implemented in the mediation layer and constructed in accordance with the 
present invention. 

Figure 13 shows a relationship usage scenario diagram between a consumer 
component and source component constructed in accordance with the present 
25 invention. 

Figure 14 is a flow chart that shows a reference resolution scenario usage 
sequence in which an indirect reference to an information element is created, passed 
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around, and then resolved by two separate data consumers, causing reconstruction to 
occur only the first time. 

Figure 15 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
5 Figures 16 A to 16B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figure 17 shows a data consumer component using a source component 
constructed in accordance with the present invention. 
10 Figures 18A to 1 8B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 19A to 19B list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
15 invention. 

Figure 20 shows a data consumer component using a source component 
constructed in accordance with the present invention. 

Figure 21 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
20 Figures 22A to 22C list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 23 A to 23D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
25 invention. 

Figures 24A and 24B show two data consumer components using a source 
component constructed in accordance with the present invention. 
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Figures 25A to 25C list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figure 26 shows a data consumer component using a source component 
5 constructed in accordance with the present invention. 

Figure 27 A and Figure 27B show a flow chart of a data exposure facility 
within the XI S framework constructed in accordance with the present invention. 

Figure 28 is a diagram of how InfoModels constructed in accordance with the 
present invention provide contextualization with the XI S framework. 
10 Figure 29 is a diagram of the pluggable service facilities within XI S 

constructed in accordance with the present invention. 

Figure 30 shows a flow diagram of a wizard or an API constructed in 
accordance with the present invention that assists in creating XML (extensible 
markup language) DSIs and database DSIs. 
15 Figure 31 shows objects and methods involved in distribution collaboration 

facilities constructed in accordance with the present invention. 

Figure 32 shows semantic repositories for distributed agents constructed in 
accordance with the present invention. 

Figures 33 A to 33P list information regarding a ContentlnfoBean class 
20 constructed in accordance with the present invention. 

Figures 34A to 34D list an information management package typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 35 A to 35F list an InfoModel interface package typically implemented 
25 in the mediation layer and constructed in accordance with the present invention. 
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Figures 36A to 36B list a package for handling change events typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 36C and 36D show two sequence diagrams showing how change 
5 events are handled and constructed in accordance with the present invention. 

Figures 37A to 37D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figures 3 8 A, 38B, 38C, and 38D show two data consumer components using a 
10 source component constructed in accordance with the present invention. 

Figures 39A, 39B, and 39C is list information concerning an AttributeAlias 
class of the framework. 

Figure 40 is a block diagram of a computer device that may be used to operate 
with the framework, in accordance with the present invention. 

15 

DETAILED DESCRIPTION 

The following detailed description illustrates the invention by way of example, 
not by way of limitation of the principles of the invention. This description will 

20 clearly enable one skilled in the art to make and use the invention, and describes 

several embodiments, adaptations, variations, alternatives and uses of the invention, 
including what we presently believe is the best mode of carrying out the invention. 

The invention will be described by way of illustration with reference to various 
classes, objects, sample codes, etc. written within the exemplary framework, but it 

25 should be understood that such classes, class libraries, application programming 

interfaces, interfaces, objects, etc. may be differently coded, implemented, designed, 
etc. and yet support the functions and features of the present invention. 
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Object-Oriented Technology 

Many application programs and APIs (application program interface) are 
developed using object-oriented (OO) technology. Using OO technology, a system is 
typically developed as a collection of interrelated cooperative objects that are 
5 instances of classes that typically include corresponding states and behaviors; A class 
is a blueprint or template that defines the variables and the methods common to all 
objects that are instances of the class. An object maintains its state in one or more 
variables and implements its behavior with methods or functions. 

Object-oriented programming (OOP) techniques encapsulate, or bind together, 

10 data and the methods that operate on them. This encapsulation permits program 
development to more closely model real- world entities and breaks up program 
development efforts into smaller, more manageable pieces. Although OOP 
techniques have done much to improve program development efficiency, such 
techniques still require a great degree of code generation on the part of developers, 

15 which discourages program reuse. 

Even with OOP techniques, specifying data sources and the way in which data 
will be retrieved or updated from the data sources are still typically hard-coded within 
the objects themselves. An object, for example, may be specified to display pricing 
data (for example, a price display object) and would likely be hard-coded such that 

20 the data source is predefined. Thus, an object may be written to retrieve data from a 
source such as a relational database management system (RDBMS), a spreadsheet file 
such as a spreadsheet in the format of "EXCEL" spreadsheet application by Microsoft 
Corporation, or the object may be written to an XML file. Nevertheless, in 
conventional systems, the price display object would be limited such that if a different 

25 source of data, for example, an XML file rather than an EXCEL file, has to be used, 
the object has to be modified to incorporate access to and manipulation of the XML 
file. Furthermore, if a different set of fields are retrieved, for example, latitude and 
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longitude (i.e., data fields unrelated to pricing information), a new object to display 
latitude and longitude may have to be written to display such information in tabular 
format. 

Table I below shows the data configuration of a typical object. 



Table I 

State/Properties: Name, SSN, position, DOB, and . . . 
Behavior: Recordf] 

getRecords(DateRange) 

promote 0 



For an application to be able to use this data object, the application would need 
prior knowledge of object properties (state) and behavior. The application would be 
tightly coupled with the class from which the object was instantiated. The meaning 
and intent of the data might be found in the source code or by asking the original 
programmers (e.g., SSN is social security number stored as string rather than a 
numeric type). 

Assuming the object was created by one application written independently of 
another, the object could not be intelligently exchanged between the first application 
and the other with the expectation that the object would be processed unless the 
applications were tightly coupled. A way to have objects be used in various 
applications is thus highly desirable to reduce programming time and resources. 

Common OOP languages include "Java" from Sun Microsystems, Inc. of Palo 
Alto, California, USA, C++, Simula, and Smalltalk. 
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Framework 

The concept of a framework is an important part of OO programming 
technique. A framework is a specification of the classes and the relationships 
between classes such that the framework defines a class hierarchy that can be used 

5 over and over again, with overrides and extensions. In this way, an initial problem 
solution specified by a class hierarchy can be adapted and customized for new 
circumstances, simplifying program maintenance. In essence, a framework is a set of 
OOP classes that embodies a predetermined set of attributes and methods for 
providing a common group of behaviors. 

10 OOP frameworks have been developed in an effort to further reduce program 

development costs. An application program developer utilizes the framework and 
builds upon it, starting with the classes, attributes, and methods defined by the 
framework designer and adding subclasses and attributes and modifying methods 
depending on the problem to be solved. Such changes to the framework are typically 

15 referred to as framework extensions, and are made possible by the OOP notions of 
inheritance and polymorphism. Thus, a framework can speed the development of an 
OO application program. The challenge confronting framework developers, then, is 
to define a set of classes and methods that best supports the desired problem solution 
and will accept the most likely framework extensions. Thus, the designer of a 

20 framework must carefully assess what framework users will most likely need in the 
way of classes, attributes, and methods. , 

It is therefore a technical advantage of the present invention to provide a 
framework that allows information-handling software to adapt to new data types and 
formats of information, so that a single application built within this framework has a 

25 significantly broader range of compatibilities and domains of usefulness than a 

conventional application and, further, may automatically interoperate at a structured 
level with other similarly enhanced applications. In one embodiment of the present 
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invention, desirable applications of data such as determining correlations between 
political party and land use strategy may be facilitated. 

In an embodiment of the present invention, a single information visualization 
or manipulation application is able to handle many diverse types of information, even 
5 those that are conceived and developed subsequently to the completion of 
development of the application itself. 

In another embodiment of the present invention, information from multiple and 
diverse sources yet sharing some basic feature in common - such as being distributed 
in geographic space, or being distances measured in meters - can be simultaneously 
10 displayed (superimposed) and manipulated within a single application. This invention 
further provides means of access to common data sources such as relational databases, 
extensible markup language (XML) streams, and "Java" programming language 
software objects. 

In an embodiment of the present invention, an information-handling 
15 application is defined as any software application which is capable of utilizing 

digitally available structured information in bulk form, such as from electronic files, 
databases, or internet web sites to provide a display and/or a set of possible 
manipulations to a user, such as after some internal processing and transformation of 
the information such as summarizing it, performing computations on it, or selecting a 
20 subset. Examples include but are not limited to graphing programs, analysis tools (for 
handling financial data, statistical, time series, etc.), and interfaces to geographic 
information systems. Prototypical information-handling applications process 
structured information that has some form of hierarchical and/or modular structure. 
In one embodiment, image and word processing applications are not examples of 
25 what we term information-handling applications. In another embodiment of the 

present invention, structured information in bulk form does not include plain text or 
specific electronic media files such as MPS files. 

12 
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A conventional information handling application such as a graphing program 
comprises two major components: one component handles the intake of information, 
from storage devices, the network, or user input, and the other component handles the 
display of the information. There may also be parts of the application that perform 
5 computations or transformations on the information before it is displayed. From the 
developer's perspective, a modular piece of software that handles a portion of (or all 
of) the data intake function is a data source component, because it provides 
information to other components within the application. A modular piece of software 
that handles part of (or all of) either the computation, transformation, or display of 

10 information is a data consumer component, because it uses (consumes) information 
provided by the data sources. 

Data sources and data consumers communicate with each other by making 
function calls. The particular functions and their parameters are defined as part of an 
internal version of an application program interface (API). The data consumer 

15 components handle data that is given them through specific calls on their respective 
API, so that information provided through data source components written for 
different applications will not be accepted. This situation provides little opportunity 
for reuse of data source or consumer components, since each is written to interoperate 
only with a specific instantiation of the other. 

20 In an embodiment of the present invention, an internal mediation layer is 

inserted between the data source components and the consumer components that 
expose data structure in a standardized way. Consumer components are constructed 
to use this common API, which is suitable for expressing an extremely wide variety of 
information types. Data source components can be constructed to deliver the 

25 information they take in this format, or a small amount of code can be written to 

translate the output of another source component into the common format. The result 
of the construction is that any consumer component can work with any data source 
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component regardless of the specific nature of the information involved, or whether 
one was anticipated during the design of the other. The common API allows 
consumer components to automatically extract whatever features of information from 
a particular source they are most suitable for displaying or computing with, and also 
5 allows them to utilize all the other features of that information in a generic, 
unspecialized fashion. 

Other embodiments of the present invention comprise: (1) a system for 
representing information such that: (a) a single fixed interface suffices to describe a 
wide range of information types, (b) the information is rendered self describing to an 

10 extent, and (c) relationships between different information elements are expressed; (2) 
an apparatus for allowing this information representation to be employed as a medium 
between data source and data consumer software components; (3) a method and 
apparatus for attaching clarifying material on "intended use" to information so that 
consumer components can handle it more appropriately; (4) a method and apparatus 

15 for providing a context to all information consumption affording control over security 
and visibility of data; (5) a method and apparatus for allowing users to transfer 
information from one consumer component to another through intuitive "drag and 
drop" and "cut and paste" interfaces; (6) a method and apparatus for developing 
enhanced information handling applications based on the foregoing framework; (7) a 

20 method and apparatus for automatically re-representing data from partially self 

describing sources including relational databases, XML streams, and Java software 
objects; (8) a method and apparatus allowing end users using computers distributed 
over a network to collaboratively view and manipulate information; and (9) a method 
and apparatus allowing software components distributed over a network to 

25 automatically obtain annotations on intent and other aspects of encountered data. 

Most aspects of this invention can be implemented in any object oriented 
programming language such as Smalltalk, Objective C, C++, or Java. Certain aspects 
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of it, pointed out below, are especially suited to object oriented languages such as 
Java and Objective C that provide for run time self analysis by programs. However, 
these are in every case peripheral aspects, and the essential parts of the invention may 
be implemented in an object oriented language like C++ without these capabilities. 
5 We will from time to time make reference to a "preferred embodiment" implemented 
in Java, but this should not be taken to be limiting. 

In a preferred embodiment the present invention provides a system and/or 
framework of software components for purposes of aiding development of 
information-handling applications. The system and/or framework of object-oriented 

10 software components aid the development of applications that read, gather, or receive 
electronic information and allow the display of such information to and manipulation 
by users. These applications are structured in a way so that there are distinct data 
source components and data consumer components. The crucial features of the 
system and/or framework are the fact that data is seen by consumers only through a 

15 standard, conventionalized interface that incorporates: a breakdown into attributes, 
relationships, semantically-annotated "domain methods", event-broadcasting of 
changes in the foregoing to all registered consumers, metadata for each attribute 
providing certain declarative and procedural information including unit of measure, 
content length, data quality, default value, comparator function, summary function, 

20 validation function, and input/output functions for display and user editing within an 
extensible set of interface modalities, related data items available for each data item 
including those in child or generic relationships, and including the ability to store a 
reference without direct access to the related item itself (it can be reconstructed if 
needed), and contextualization such that the attributes, relationships, events, and 

25 methods available for a data item depends on context (see below). 

In a related embodiment, the system and/or framework includes methods for 
data exposure wherein the system determines automatically which method is 
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employed in any particular case, and the choice is invisible to consumers. Exemplary 
methods such as, a data source component which directly provides the standard 
interface, a data source component which is accompanied by a separate Translator 
component which maps its interface to the standard interface; and a data source 
component which is automatically inspected by the system to determine what 
available data fields it has, these are exposed to consumers through the standard 
interface as detailed above. 

In a preferred embodiment, the contextualization provided by the system 
and/or framework is accomplished by delegating the final responsibility for data 
exposure to an object termed an "InfoModel" which is able to choose which of the 
available attributes and methods on an object should be exposed or hidden, and is able 
to add additional attributes or methods. Preferably, the system and/or framework 
further provides facilities supporting transfer of data items between consumers, either 
by user manipulation (cut/paste or drag/drop) or by internal method calls. When a 
transfer is initiated, the data item is passed without its contextual characteristics 
(supplied by an InfoModel) to the receiver. The system and/or framework includes 
facilities supporting the automatic integration of service components (generally 
comprising management facilities such as menu provision or running of user dialog 
routines and may or may not have data source provider and/or user interface provider 
components) into an application. Integration is handled by a plug-in manager object 
and set of interfaces such that: each service provider is given the opportunity upon 
loading to query all components (data providers or consumers) existing within the 
application for whether they desire the service, and if so what parameters they would 
like to pass to it. The provider then acts on these responses. Whenever new client 
components are loaded, they will be queried and possibly responded to by all services 
loaded within the application. 
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In another embodiment a system for importing partially schematized or 
structured data sources (such as a database system or an XML document) into a 
system as described herein. Any application written using the disclosed system 
and/or framework can then utilize these data sources through a standard interface. In 
5 particular, a system and/or framework for performing all or a substantial portion of 
the functionality outlined herein - if it is in connection with a framework or 
application implemented using a framework falling under categories as disclosed such 
as an infrastructure for mediating between information sources and consumers and 
rapidly assembling applications using them. 

10 Thus the present invention provides a method and apparatus involving two 

subsystems, one which processes the schema information for a data source to 
determine the type and metadata information for information attributes from the 
source, and one which processes the instance information. Preferably, the schema 
subsystem processes schematic information such as the type information contained in 

15 an XML schema document or the column information available from a relational 
database management system and sets up appropriate metadata and relationship 
structure for information elements, but it does not necessarily create any information 
elements. Optionally, additional annotations can be provided by a user in the form of 
a file specifying how to map attributes in the original data to metadata, relationships, 

20 or domain policy attribute or method definitions. Preferably, the instance subsystem 
processes instance information such as that available from an XML document or set 
of relational database rows, for which corresponding schema information can be 
found, and constructs information elements exposed through the standard interface. 
Data consumers can utilize the outputs of these as if they were custom-created data 

25 sources for the type of information described in the schemas. 

In a related aspect, implementation of the invention as described herein for 
both XML and relational databases is provided. In the XML implementation, a built- 
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in data type hierarchy for XML schemas is used to provide types to attributes, and the 
element-subelement-attribute structural hierarchy in XML schemas is used to 
determine relationships between information elements. All documents and schema 
references to other documents are followed up to their sources in order to specify 
5 further attribute or relationship information. A user can optionally specify an XSLT 
(XML Stylesheet Transformations) document that maps the typed data fields found 
from the instance-schema combination into attributes with richer metadata and/or 
references to specific domain policies. In the database implementation, the table 
column heading types from the relational database (date, integer, text, etc.) are used to 

10 provide default type metadata to the attributes of information elements derived from 
table rows of the database. A user can optionally specify a mapping between columns 
or sets of columns into attributes with specific metadata. Furthermore, a user can 
define a sequence of queries for which the results are to result in a hierarchy of 
information elements. For example, for each information element retrieved from, for 

15 example, Query 1, a parameterized instantiation of Query 2 may be applied to retrieve 
elements which will be exposed as the children of the first information element. For 
each of these elements, a parameterized instantiation of Query 3 may be instantiated, 
and so forth. 

Framework Block Diagram 

20 Figure 1 shows a basic block diagram of a framework that is implemented in 

accordance with the present invention. The framework 100 of Figure 1 can be used to 
develop, for example, an information-handling system or application wherein data 
source components 102 and data consumer components 122 are separate and 
independent from each other but can communicate and share data. The framework 

25 100 described herein shall be called the extensible information system (XIS) 
framework. 
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From a developer's perspective, a modular piece of software that handles part 
or all of the data intake or retrieval function is a data source component 102. A 
modular piece of software that handles part or all of either data computation, 
transformation, presentation, or display of information is a data consumer component 
5 122. A conventional information-handling application such as a graphing program 
comprises two major components: one side handles the intake of information from 
storage devices, the network, or user input, and the other side handles the display or 
presentation of the information. There may also be parts of the application that 
perform computations or transformations on the information before it is displayed. 

10 XI S Framework 

In the XIS framework 100 constructed in accordance with the invention, there 
may be more than one data source component 102 (also referred to as a source, data 
source, source component, and source object) and there may be more than one data 
consumer component 122 (also referred to as a consumer, consumer object, consumer 

15 component, and data consumer). The data source components 102 provide 

information to other components within the XIS framework 100 via a mediation layer 
1 12, while the data consumer components 122 use the provided information. 

The source components 102 and consumer components 122 that comprise the 
XIS framework 100 are configured such that they communicate with each other in a 

20 manner that is supported by the programming environment in which the framework 
exists, typically by making function calls, via the mediation layer 112. In one 
embodiment, the mediation layer 112 consists of a group of application programming 
interfaces (APIs) or class libraries that define a common format for data exchange, 
establishing an information exchange standard. Thus, data source components 102 

25 configured for a different system, application, or framework may still be used within 
the XIS framework if they are "wrapped" in a predetermined way or are suitably 
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modified, as will be known to those skilled in the art, such that they conform to the 
requirements of the data exchange interface of the mediation layer 1 12. 

A relatively simple block of programming code may be produced to translate 
the output of a data source component 102 into the common format as defined by the 
5 mediation layer or API 112. In this way, any consumer component 122 may work 
with any data source component 102 regardless of the specific nature or type of 
information involved and regardless of whether the data source component was 
known or anticipated during the design of the data consumer component. Because of 
the XIS framework described herein, the data consumer 122 may also extract 

10 whatever features or sets of information that it needs or can process from one or more 
data source, thereby enabling the data consumer to utilize features and information in 
a generic unspecialized fashion. 

The mediation layer 1 12, which is between the data source components 102 
and the consumer components 122, exposes the data structure of the data source 

15 components 102 in a manner that is common for the framework, preferably through 
an API interface. Data consumer components 122 are constructed to use this common 
API, including utilizing the exposed data structure. The data consumer components 
122 are suitable for expressing an extremely wide variety of information types. In 
addition, the data consumers may be constructed to deliver the information received 

20 from the mediation layer to another data consumer component, or to output the 
information received for display. 

Data consumer objects 122 are application or software objects or components 
that use data, or may be said to consume it. Examples of data consumers include 
display programs that display data in tabular format, in graphical mode, in 

25 organizational chart mode, spreadsheet mode, timeline mode (similar to files in the 
format of the "PROJECT" application from Microsoft Corporation), and the like. 
Data consumers may be desktop based, web-based (Internet-based), distributed 



20 



WO 02/46916 



PCT/US01/48418 



architecture, interpreted programs, and the like. Data consumer components within 
the XIS framework may provide display, computational, or interactive facilities. In 
the present description, such specially configured data consumer components are 
referred to as "INFOBEAN" objects, as available from the assignee of the present 
5 invention, Polexis, Inc. of San Diego, California, USA. Those skilled in the art will 
understand how to extend the framework 100 to produce desired applications, in view 
of the description herein. 

Figure 2 shows additional details of the mediation layer 1 12 in the framework 
100. In the framework 100, four special types of interfaces may be exposed to the 

10 data consumer components 122. These four interfaces include Domain Definition or 
Domain Policy 202, Relationship 210, Attributes/Metadata 214, and Change Event 
216. In one embodiment, change events are registered within the XIS framework 100. 
These interfaces may be exposed, for example, through class and object libraries that 
may be developed for the XIS framework. With these pre-defined class and object 

15 libraries and APIs, developers of data source components 102 and data consumer 
components 122 may independently develop their own source and consumer 
components, thus facilitating development of information-handling applications or 
systems. An example of a class that may be implemented or written in the mediation 
layer to facilitate development of source and consumer components is illustrated in 

20 Figures 33 A to 33P, which show details of a sample class called ContentlnfoBean. 

Domain definitions or policies 202 (also referred to as domain objects or 
simply domains) are optional within the XIS framework 100. If defined, the 
corresponding Domain methods 212 for such policies are exposed to the data 
consumers 122. Other information about the domain policy may also be exposed, 

25 such as Attributes/metadata 214 and Relationships 210 for that particular Domain 

Policy. Attributes/Metadata 214, Change Events 216, and Relationships 210 may also 
be exposed within the XIS framework 100, even if domain policies are not defined. 
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Relationships show the relationship between data source components. 
Containment, hierarchies, and ad-hoc relationships, for example, may be shown. 
They may be expressed as "members of and references. Relationships are thus 
recognized and may be obtained accordingly, as shown in Figure 14 described further 
below. 

Change events may be used to ensure that all consumer or source components 
that have an interest in another source component's data are notified when changes 
occur. Changes may be notified when attributes, members (or containers), or 
references (or referrers) are added, updated, or removed and when values are changed. 

Once a data consumer component 122 obtains a reference to a data source 102, 
the data consumer component may obtain access to these interfaces 202, 210, 212, 
214, 216 through method calls in accordance with the programming environment of 
the host computer system. The data consumer 122 obtains such a reference typically 
in preparation to consume or use information from at least a particular data source 
102. Examples of such consumer component method calls include: 
get attributes; 

get member and container information elements; 

get referred and referring information elements; 

get unique ID and selection state; 

add and remove instance specific attributes; 

register to be informed of changes to attributes or relationships; 

and 

invoke method calls of a semantically annotated type, described 
below. 

These types of method calls will be familiar to those skilled in the art and familiar 
with the programming environment of the host computer system. 
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Figure 3A is a schematic diagram showing the information about data source 
objects that is exposed by the mediation layer 1 12 in Figures 1 and 2, as well as the 
services available within the XIS framework 100. In accordance with the invention, 
data source components are wrapped with an object that exposes the interface 
5 information for the data source to data consumers through the mediation layer. 

In the preferred embodiment, the wrapper around each data source is an object 
provided by a class called InfoModel. As shown in Figure 3 A 5 a data source 
comprising a raw data item 351, via the APIs 1 12 as described above, offers a variety 
of information, as shown in the blocks 354, 356, 358, 360, 362, through which data 

10 consumers may gain access to the data source. The information represented by the 
blocks 354, 356, 358, 360, 362 is exposed or may be contained within an InfoModel 
350, which provides an information space for all information available in the XIS 
framework 1 00 for the wrapped data source component. In one embodiment of the 
invention, the data needed by data consumers are accessed via such InfoModels (such 

15 as further illustrated in Figure 28). The wrapper provided by the InfoModel is called 
a LeifDataltem object 352. Thus, the InfoModel is an interface that permits data 
sources and data consumers of the XIS framework to independently share their data. 
In this way, the methods 360, domains 358, metadata 354, relationships 356, and 
other information of a data source object are thus exposed using the InfoModel object, 

20 which may be said to exist in the mediation layer 112, which sets up contexts for data 
consumption. The XIS framework also provides additional data services through the 
mediation layer, such as the Plug-In Service 264 and BeanContext Service 266 
indicated in Figure 3 A. These services provide the functionality listed in their 
respective boxes 364, 366. Other data services may be provided, as desired. 

25 The InfoModel object provides a context for information access, i.e., context is 

instantiated through the InfoModel concept. In this way, security may be enforced, 
considering that the conceptual or real "end-user" accessing the information is known 
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and thus the underlying data source may be forwarded correctly. Furthermore, 
through this InfoModel concept, an embodiment of the framework may be 
implemented such that attributes and methods may be added or removed by the 
framework user. Original attributes and methods in one context may also be 
5 overridden. 

An attribute is any property of an object. In one embodiment of the invention, 
an attribute may be coded with an " AttributeDescriptor M . An AttributeDescriptor is 
provided by the object or its Translator to describe a property of the object using 
TypeMetaData, e.g., how to display it, how to edit it, its permitted ranges, and the 

10 like. Translators map data source-specific structures and types to an XlS-generic 
representation. Translators are further discussed below. Attributes may also be 
defined using Java introspection or reflection, as discussed further below. 

Dynamic attributes may also be exposed within the XIS framework 100. 
These attributes are attributes that are exposed during run time, such as, for example, 

15 a database query wherein each column is an attribute revealed at run time. The 
mediation layer has a mechanism that captures such information. In the preferred 
embodiment, the XIS framework operates in conjunction with a database management 
application, so that the mediation layer utilizes run time database query mechanisms 
that generate metadata of the data object, such as data table column headings, data 

20 types, and the like. Such mechanisms may be provided, for example, by SQL queries 
and the like. In one embodiment, data consumer applications using the XIS APIs are 
unaware of whether an attribute for a data item is obtained dynamically or statically, 
so that the process is transparent to the application user. 

A domain is a collection of semantically meaningful attributes and method 

25 signatures grouped by their common domain of interest. Examples of domains 

include a Display Domain (a domain that describes how to display information) or a 
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Geo Domain (a domain that specifies how to handle geographic information). 
Domains are further discussed below. 

The contextualization provided by the XIS framework system is accomplished 
by delegating the final responsibility for data exposure to an object termed an 
5 "InfoModel", which is able to choose which of the available attributes and methods of 
an object should be exposed or hidden, and is able to add additional attributes or 
methods. Preferably, the system and/or framework further provides facilities 
supporting the transfer of data items between data consumers, either by user 
manipulation (cut/paste or drag/drop) or by internal method calls. This supports data 

10 sharing among data consumers. When a transfer is initiated, the data item is passed 
without its contextual characteristics (which are supplied by an InfoModel object) to 
the receiver, i.e., only non-contextual information is transferred. In this way, the 
source data may remain unchanged. 

As illustrated in Figure 3 A, a FieldMetaData file 354, a type of metadata, is 

15 used to represent sorting, subset, and visibility criteria for an attribute. This is further 
explained below in conjunction with Examples 1 to 5, wherein subsets of data are 
shown depending on whether "All Attributes" or "Preferred Attributes" are shown. In 
one embodiment of the invention, default behavior method of domain policy attributes 
may also be overridden. Within this framework, context-specific special attributes for 

20 flagging whether a data item should be visible or not (e.g., can be used for display 
filtering, including the XIS value slider, tree checkboxes in the map view, etc.) may 
be defined. This may be achieved through the mediation layer by utilizing a user 
interface to modify display processing for the data item. Furthermore, a selection 
attribute that is a context-specific special attribute for flagging whether an object is 

25 "selected" (and typically should be highlighted) may also be defined. Selected pieces 
of information are often shared among views (context-specific, though), and certain 
operations may be performed on the set of selected objects in a given context 
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The InfoModel objects as described above know how to return a data item (a 
LeifDataltem) given a corresponding raw data source identifier. The InfoModel also 
manages these data items. As indicated in Figure 3 A, an InfoModel may contain one 
or more LeifDataltem objects, each of which provides an interface to a raw data item. 
5 An application developer may use an InfoModel object 350 to get a LeifDataltem 
object 352 in order to use the XI S APIs for accessing the underlying data source in a 
generic fashion. If two different data consumer components ask for a data item (e.g., 
a LeifDataltem) from the same InfoModel for the same raw data source, then both 
data consumers will get the same instance of the LeifDataltem object. InfoModel 

10 objects may also be nested as indicated in Figure 3B. 

Information becomes normalized in the XI S framework so that any application 
can use an object's information by getting attributes and relationships dynamically at 
runtime. Therefore, instead of hard-coding a visualization program to a specific type 
of object, the visualization looks for the attributes it needs to perform its function. 

15 Thus, the developer of the data consuming module may obtain the information needed 
from the XI S LeifDataltem class, which wraps raw data item objects and exposes 
them to the data consumer through uniform APIs. The visualization can access all the 
information exposed, through the XIS APIs and techniques, as needed. If the data 
source provides AttributeDescriptor objects or translates the properties to domain 

20 attributes, then the information can be interpreted more intelligently in domain- 
specific ways. In one embodiment of the invention, the XIS framework also offers 
APIs and a programming model (or design pattern) that extends Sun's JavaBean 
pattern with XIS information awareness. These extended JavaBeans comprise 
"smarter JavaBeans" that are provided in the XIS framework as the specially 

25 configured INFOBEAN objects and, like JavaBeans, INFOBEANs can be visual or 
nonvisual components, and can be graphically combined in any standard Java 
development environment. 
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InfoModel Class Objects 

In one embodiment, there are four types of InfoModel s in the XI S framework: 
BaselnfoModel : 

A single BaselnfoModel is required because it is responsible for creating and 
5 caching every BaseDataltem (data item) wrapping a Java object (the raw data item 
object). The BaselnfoModel object holds any object used as a LeifDataltem until the 
data item is no longer needed (i.e., until it is no longer strongly referenced). 

SelectablelnfoModel : 

A super class of BaselnfoModel, this InfoModel delegates to any other 
10 InfoModel (typically the BaselnfoModel), and creates SelectableDataltems (data 
items that are selectable). The SelectablelnfoModel objects add a selected Boolean 
attribute and delegate to the LeifDataltems from the prior InfoModel. Since the 
BaselnfoModel is a SelectablelnfoModel, all LeifDataltems have a selected attribute. 
This is true because any LeifDataltem is either in the BaselnfoModel itself, or is in an 
15 InfoModel that is nested in the BaselnfoModel and, therefore, inherits the selected 
attribute from the BaseDataltem. Additional SelectablelnfoModels can be 
instantiated to create independent contexts for selection state, independent of other 
InfoModels. 

AttributeFactorylnfoModel : 
20 This InfoModel allows AttributeFactory classes to be registered so that every 

time a LeifDataltem is created, it enables attribute factories to add additional 
attributes to each LeifDataltem. 
InfoModelSubset : 

A super class of SelectablelnfoModel and AttributeFactorylnfoModel, this is 
25 the simplest InfoModel. It delegates to its parent InfoModel and creates 

LeifDataltems that wrap those XI S data items from the other InfoModel. This 
InfoModel does not automatically add any attributes to the LeifDataltems it creates 
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and manages, but simply provides a context in which data items can be managed. 
Each InfoModel "layer 11 provides a context in which additional attributes can be 
defined, or existing ones can be overridden. Figures 34A to 34D list an exemplary 
Java package that lists various classes. Figures 35A to 35D list the InfoModel 
5 interface. An interface is a contract in the form of a collection of method and constant 
declarations. When a class implements an interface, it promises to implement all of 
the methods declared in that interface. 
Exposing Data 

Figure 4 is a diagram showing how information from source components may 

10 be exposed to data consumers using the mediation layer 1 12. The Attribute/Metadata 
interface 214 of Figure 2 exposes a data item 440, 442 as a set of attributes, each of 
which carry a value and a set of metadata that describes the value. A data consumer 
component 420, 422, 424 may obtain information from one or more data items. 
Similarly, a data item 342 may be used by more than one data consumer 422, 424 via 

15 the mediation layer or API 1 12. The information blocks 460, 461 show the 
information available to data consumers. 

A data source component 102 may comprise a data source interface (DSI) 
object 412, 414. A DSI object 412, 414 provides a conceptual way to encapsulate 
objects that provide data to the XI S framework 100. A class of a DSI object does not 

20 have to extend or implement any interface. Data is created (instantiated) in DSI 
objects to thereby encapsulate the data and make it available to other objects. The 
DSI itself may also be a data item that simply contains other data items (members). 
The data may be generated internally or extracted from an external source such as a 
database or across a LAN. In addition to creating the data, DSI objects are also 

25 responsible for maintaining and controlling data, such as removing and updating the 
data themselves if such changes are observed in the underlying data used by the DSI 
to create the data. Property change events (216 of Figure 2) may be used by DSIs to 
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communicate changes observed in the original source data items to the listening data 
consumers. 

Any Java object may be a data source component. The Swing JButton, for 
example, is usually a transient object, and not typically retrieved in an information 
5 system. The Swing JButton, however, may still be a data source, if so desired. 

INFOBEANs as stated above are data consumer components 420, 422, 424. 
They are specially configured objects that behave like JavaBeans that process and 
manipulate data in a generic fashion. They are also capable of interpreting and 
optionally displaying XIS data items. INFOBEANs use the XIS framework API's to 
10 gain access to information about data items. 

As previously stated, any Java object may become a data item 440, 442 within 
the XIS framework 100. To make a data item out of JSlider (javax.swingJSlider), it 
simply must be added to an INFOBEAN (data consumer component). Table II below 
provides programming code that makes a data item out of javax.swing. JSlider, thus 
15 exposing the information blocks 460, 461 shown in Figure 4. 



Table II 

Jslider slider = new Jslider(0, 100,50); 
tablelnfoBean.addRawDataltem(slider); 



The first line of code creates a data item out of JSlider. The second line of 
code adds the JSlider created in line 1 to the TablelnfoBean object (an INFOBEAN). 
20 In this framework, JSlider knows nothing about the XIS framework, however, all its 
attributes are exposed, to be used and modified. 

There are basic steps that must be performed when creating a DSL First, 
before any code is actually written, a determination must be made as to how the 
original data or data source is to be obtained (e.g., will it come from a database, a flat 
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file, an EJB (Enterprise JavaBean), read from a socket, etc.). This step is performed 
prior to and independent of coding the DSL Once the data source has been 
determined, it must be decided what attributes of the data source should be exposed 
within the XIS framework. 
5 The DSI component within the mediation layer of the XIS framework has the 

capability of exposing the attributes of a data source. In one embodiment, assuming 
that the data source is a Java object, the attributes to be exposed are determined 
through Java introspection. Introspection is a way to determine a bean's properties, 
methods, and events. Those skilled in the art will understand that a bean is a reusable 

10 software component, which may be combined to build applications. In this scenario, 
no additional code in the consumer component needs to be written. Although 
convenient, this approach is limiting, as it does not allow control over which attributes 
are exposed, and does not allow the user to define custom visualization components or 
express semantics. Furthermore, it requires the Java object to conform to the 

15 JavaBean design pattern. 

Another approach to determining which attributes of a data source should be 
exposed involves writing new code. This approach embeds XlS-aware code directly 
into the Java object. This allows the component developer to directly specify details 
such as the attributes (e.g., via AttributeDescriptor) to be exposed along with their 

20 metadata, the Domains to which the DSI subscribes, which Domain methods are 
exposed with what implementations, and more. Writing new code enables greater 
control over the data item (as opposed to the introspection-only case) and provides 
more flexibility in dealing with any Java object rather than just JavaBean objects. 
One limitation of this approach is that the relationships between data items may not be 

25 directly specified. 

Another approach for exposing attributes is to create a Translator class. An 
application developer may place any of the XlS-aware code for exposing attributes, 
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Domains, and the like in this class, as specifying relationships to other data as 
members or as references. This is described further below, in conjunction with the 
description of Figures 21 to 23. 

Referring back to Figure 4, a data consumer 420, 422, 424 may access a data 
5 source via a data source interface (DSI) object defined in the mediation layer 112. 
Communication between the DSI objects 412, 414 and data consumers 420, 422, 424 
in the framework 100 is mediated through a set of application programming interfaces 
(APIs) 112 that remain independent of the actual contents and types of the data 
sources. Such APIs are contained in class libraries. 

10 Using the framework 100, a data consumer 420, 422, 424 (for example, an 

INFOBEAN as shown in Figure 6B) may be able to use heterogeneous data sources 
and, thus, eliminate the need to write a particular display software object for each 
particular data source. Within this framework, any data consumer object or 
application may use the data source object's information by getting attributes and 

15 relationships dynamically at run time. Instead of hard coding a visualization to a 
specific type of data source component, the visualization object or data consumer 
looks for the attributes it needs to perform its function. Thus, in this framework, 
developers for source and consumer objects may work independently of each other. 
The DSI object may create any data structure containing members and 

20 references, and may expose any part of that data structure to the framework or system 
100 if it is desired. Since there are no requirements involved to be a data source, a 
visualization bean can also be a data source. The data source can consume data from 
other data sources, and can create new data based on what it has learned- For 
example, DSI objects may be coded to use data source from an RDBMS, e.g., systems 

25 such as provided by Oracle Corporation of Redwood Shores, California, USA and as 
provided by Microsoft Corporation of Redmond, Washington, USA through their 
"ACCESS" application or SQL Server. DSI objects also may use data sources such as 
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XML format data, tabular data (e.g., spreadsheet data such as spreadsheet files in the 
format of the "Excel" application from Microsoft Corporation), email, schedules (e.g. 
schedule data in the format of the "PROJECT" application from Microsoft 
Corporation), data following the SNMP (simple network management protocol), and 
5 the like. 

Objects created by DSIs are considered to be raw objects in the XIS platform. 
These raw objects become normalized objects within the XIS framework when they 
conform to the mediation layer or the API 112. In one embodiment, when these raw 
objects are added to an XlS-enabled environment, the XIS framework wraps them 

10 with a normalized object called a LeifDataltem (see Figure 3 A) and holds the data 
item in one or more InfoModels. The raw data item could be a simple Java object 
(that does not know anything about XIS) or it can support XIS with direct references 
to AttributeDescriptors and other metadata that are recognized by XIS. The 
mediation layer is implemented in software and runs in-process. It is also exportable 

15 to serve as a distributed middleware if required by a given application. 

An attribute is any property of an object. An attribute 474, 475 typically 
includes identity (ID number) 476, 477, name of the attribute 478, 479, value 480, 
481, and the metadata type or Type Metadata 482, 484, and a description 484, 485. 
Attribute names 478, 479 may be the table column header or field name in an 

20 RDBMS. The description of the attribute 484, 485 may be plain text that explains the 
attribute. The value 480, 481 may be expressed as a number, string, or other basic 
data type, or may be expressed as a complex, structured object in itself. 

Referring back to Figure 2, the Attribute/Metadata interface 214 provides for 
fine-grained exposure of an information element or data item 440 442 (Figure 4); by 

25 "fine-grained" is meant that the data item is broken down into a number of aspects or 
characteristics (the "attributes") which are simpler data elements. These might be 
numerical values, strings, arrays, or anything else that can be represented by a 
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software object (but is simpler than the original element). If a data consumer 412, 
414 is not able to handle the entire data element, it may be able to handle some of its 
attributes and therefore may be able to do something useful with it, unlike most 
systems providing interfaces for data integration, which require the entire interface to 
5 be implemented to enable any data usage. 

The Attribute/Metadata interface 214 also makes each attribute self-describing, 
to a limited extent. In accordance with the invention, a data consumer designed 
without regard to a particular type of attribute is still able to display and perform 
limited operations with those attributes by using the metadata types. For example, a 

10 data consumer object or INFOBEAN, which displays an X and Y chart of cost of 
living (expressed as a numerical value) versus geographical location (expressed as a 
territory or state character string, e.g., "California"), may be used to display a different 
set of data contained in another data source component or data item, so long as the 
metadata types of the different sets of data are compatible with the X and Y chart. In 

15 particular, a data consumer component that renders and edits information may still be 
executed, the default value substituted in cases of absence, and statistical 
summarization performed, even if the data consumer component is processing a 
different data source component. Other operations are possible and additional 
metadata may be provided by developers for any identified classes of information 

20 elements (such as number, array, geographic entity, etc.) desired. Because of this, 
data consumer developers may identify the type of auxiliary information or 
procedures provided by the consumer component and then define the interface 
according to which other developers creating data sources should provide or expose 
their metadata. 

25 In one embodiment, any property or attribute of an object may be defined with 

an AttributeDescriptor programming code. When a data source object is enabled 
within the XIS framework, the computing system automatically creates 
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AttributeDescriptors for JavaBean properties and for some public properties. A 
JSlider object, for example, is a JavaBean. JavaBeans have properties that are defined 
by the get<property> and set<property> methods. If the object is a JavaBean and 
provides a Beanlnfo, then it will be honored and treated according to the JavaBean's 

5 specification for Beanlnfo classes. Only properties listed in the Beanlnfo appear as 
attributes. If metadata types, further discussed below, support the property's type, 
then they appear as attributes for that data item. Any properties that do not have 
TypeMetaData support become data items themselves (using the same reflection and 
introspection rules) and are listed in the data item's reference array, retrieved by the 

10 LeifDataltem getReferencesQ method (i.e., a method to obtain the references). 

Translators translate various data item classes, thereby enabling seamless integration 
of various data items without code modification. Translators may also be added to 
augment object reflection and introspection, i.e., by developers directly specifying the 
properties of an object. 

15 Table III below lists exemplary programming code to define attributes. Table 

III shows how to define a SIZE attribute. 



Table III 

public static AttributeDescriptor SIZE; 
static { 

AttributeDescriptorFactory factory = 

AttributeDescriptorFactory.getAttributeDescriptorFactory(); 
SIZE = factory, create AttributeDescriptor( 

"size", Your.class, 

new NumericTypeMetaData("Size", long.class, 
UnitsOfMeasure.BYTES, 6)); 
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} 



Metadata are data or information regarding data, for example, data type, field 
name, length, value restriction, color, and the like. In practice, metadata are used to 
5 define the structure and meaning of data objects in tools, databases, applications, and 
other information processes. The data type metadata 482, 483 encompasses both 
procedural and declarative information, including (as appropriate for the value) but 
not limited to the following: 



10 - unit of measure (from the provided unit of measure software 

object, converters to/from other units are accessible); 
content length; 

default or maximum character length or precision of numbers; 
data quality (a rating given by the provider of the data); 
15 - default value (given by the provider of the data type); 

constraints (e.g., numeric range or list of acceptable values); 
formatting; 

comparator function (a procedure which takes two items of the 
data type in question and returns whether one is to be ordered 

20 before, after, or the same as the other); 

validation function (returns 'true' or 'false 1 depending on whether 
the value for the attribute passes a certain test or set of tests, tests 
are developer-definable based on an interface which takes a 
software object providing a value and returns a Boolean value, 

25 but several reference implementations are provided, such as one 

to determine whether a number is within a specified range; 
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list of applicable summary (statistical) functions, summary 
functions are developer-definable based on an interface which 
takes a collection or array of software objects providing values 
and returns a single value (usually, but not necessarily of the 
same type) based on those values, several reference 
implementations are provided, including mean, standard 
deviation, count, max, min, median; and 
renderer and editor procedures for different output modalities 
(examples of modalities include local graphical window, HTML, 
plain text, and WML). 

A renderer displays a value, while an editor allows the user to enter or edit one; 
Tenderers and editors are both developer definable for any modality desired. In the 
preferred embodiment, renderers and editors for graphical windows, HTML, and plain 
text are provided. 

In a simple example, a data item may have an attribute called "Manager" 
(attribute name) 478, 479 that has a value of "John Doe," 480, 481 with metadata type 
482, 484 of content length (e.g. "30"), data type ("string"), and default value (""). In 
another example, a data item may have an attribute called "Cost" 478, 479 that has a 
value of "5.00" 480, 481 with metadata type of data type ("float"), default value 
("0.0"), summary statistics ("true"), validation function ("can never be less than 
zero"), and the like. 

The Attribute/Metadata interface specifies generic type accessors for object 
comparing, editing, formatting, rendering, and validation. This displaces the burden 
from the consumer of the data (INFOBEANs) to the developer of the TypeMetaData. 
It enables developers to use existing TypeMetaData to create content that is viewable 
in many forms such as a Swing Component, HTML table, and WML text. 
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In one embodiment of the invention, the data consumer components are very 
generic, requiring little or no Domain-specific knowledge. For example, a data 
consumer object, for example, which resembles a spreadsheet, displays all available 
attributes of any data item, regardless of the Domain Policies represented. If useful to 
5 this consumer object, the metadata types may provide graphical control components 
for rendering attribute values. They also may supply editor components that give the 
end-user a standard way to modify an attribute, e.g., a color chooser GUI for selecting 
a new color value. 

An input/out metadata class, TypelO, defines the end content format. The 
10 TypelO class offers flexibility in both the input (editing) and output (rendering) of 
attributes according to their type. In one embodiment, a TypelO object is registered 
for a specific TypeMetaData using a registry, for example, the TypelORegistry. The 
registration is performed on the following interface types: HTMLTypelO, 
SwingTypelO, TextTypelO and WMLTypelO. Examples of Type IO are "Swing 
15 Type IO" (for Java standard user interface library called "Swing"), HTML (hypertext 
markup language), WML (wireless markup language), XML (extensible markup 
language), and text. Swing is a graphical user interface (GUI) component kit, part of 
the Java Foundation Classes (JFC) that are integrated into the Java programming 
language. Swing simplifies deployment of applications by providing a complete set 
20 of user-interface elements written entirely in the Java programming language. Swing 
components permit a customizable look and feel without relying on any specific 
windowing system. 

Table IV below is exemplary code to register two different TypelOs for the 
BooleanTypeMetaData. 

25 

Table IV 

static { 
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TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 

SwingTypelO. class, 

BooleanSwingTypelO.class); 
TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class ? 

TextTypelO. class, 

BooleanTextTypelO . class); 

} 



In one embodiment, the metadata type may be overridden. For example, it is 
possible to override the editing/rendering capabilities of a TypeMetaData. In one 
5 embodiment, a new TypelO implementation is registered that provides the desired 
editing and rendering. If a developer only wants to affect the TypeMetaData instance 
that the developer is using, a subclass must be created and the TypelO registered with 
that subclass. Thereafter, any instances of the new subclass will use the specified 
TypelO. 

10 Other features may also be added to the TypeMetaData, such as summary 

function, min function, max function, and the like. For example, 
BooleanTypeMetaData adds summary methods for obtaining the total of false and 
true counts. Exemplary code to perform this modification is listed in Table V below. 



15 

Table V 

static { 

TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 
SwingTypelO.class, 
BooleanSwingTypelO.class); 
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TypeIORegistry.registerTypeIO(BooleaBTypeMetaData.class ? 
TextTypelO.class, 
BooleanTextTypelO.class); 

} 

* Constructs a <b>BooleanTypeMetaData</b> with <i>name</I> 

* @param name the type name, returned by getNameQ. 

*/ 

public BooleanTypeMetaData(String name) { 
super(name); 

addSummaryFunction(new FalseBooleanSummaryFunction(this)); 
addSummaryFunction(new TrueBooleanSummaryFunction(this)) ; 

} 



Methods may also be added to the TypeMetaData interface to provide standard 
behavior. Constraints may also be specified. Table VI below lists exemplary code to 
5 define a StringTypeMetaData called "Threat" with only three valid values 
("HOSTILE," "FRIEND," and "NEUTRAL"). 



Table VI 

new StringTypeMetaData("Threat", 3) { 
{ 

setValidTest( 
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new DiscreteRange() { 

{ 

add("HOS"); 

add("FRI"); 

add("NEU"); 

} 

} 

); 

} 

} 



In one embodiment, an INFOBEAN data consumer is given a data item. The 
consumer examines the data item and its attributes, and may also access certain 
5 Domain attributes or execute Domain methods. If the consumer finds something it 
can use, the data item is further processed according to that consumer's function. For 
example, a user might drag a group of data items to an INFOBEAN that displays time 
relationships. The INFOBEAN would ignore those data items that did not have any 
appropriate time-related attributes. For those data items that have time-related 

10 attributes, the values can be obtained and used to populate a user interface. 

Referring back to Figure 2, the Domain Definition/Policy interface 202 
provides a means for the intended use of an attribute in a data item to be conveyed 
along with the attribute itself. A domain policy typically comprises a list of attribute 
types with metadata and a list of function calls applicable to data possessing some or 

15 all of the attributes with parameter specifications, annotated with English text 
expressing the intent (i.e., description of the attribute). It is a group of related 
attributes (or properties), along with their semantics to usefully deal with data 
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processing those attributes, particularly to define the specific intent of the attribute or 
method. The semantics are specified in the attribute TypeMetaData and in natural 
language. Software developers of both sources 102 and consumers of data 122 may 
refer to a domain policy in making design decisions, thereby ensuring that an attribute 
is handled in a more sensible manner than the limited self describing capabilities 
provided by metadata alone would allow. Domain policies indicating intended use of 
a set of information that are well understood, for example, by experts now may be 
mapped and aligned so that common features of different sources of data may be 
combined along common lines. 

A domain policy typically has no knowledge of the data items that use the 
attributes from those domains or the data consumer components that use them. 
Domains are just a related collection of Attributes and methods from which the 
various data item classes are free to choose. 

In one embodiment of the invention, every data item in the framework 
provides a list of domain policies it "subscribes to" when requested by a standard 
method call. For example, a geographical domain policy is defined within the 
framework 100 to handle a set of three numerical values (longitude, latitude, and 
altitude) to define the position of, for example, an airplane. This domain policy or 
domain interface is defined in the mediation layer 112 so that the data source 
component 102 and the data consumer component 122 may interface with each 
properly. In this scenario, data source component 102 exposes the three numerical 
values properly (i.e., as latitude, longitude, and latitude). The data consumer 
component 122, on the other hand, understands this pre-defined domain policy and 
thus is able to properly handle these three attributes or values, such that, the location 
of this airplane may be plotted on a map (like the one shown in Figure 1 A), distances 
between positions calculated, and the like. 
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Two or more modules (consumer and source) may subscribe to the same 
Domain. This, however, does not preclude the modules to be developed 
independently. A Domain Policy in one embodiment is defined by Java classes that 
declare a set of attributes and methods that might be supported by a given data item. 
5 For example, a temporal domain defines start time and duration as attributes. A 
timeline may only be properly plotted if such software object understands which 
attribute represents the start time and which attribute represents the duration or the 
end time. For this to work in XI S, two classes would need to exist: TemporalDomain 
and TemporalDomain Wrapper. The TemporalDomain class defines the 

10 AttributeDescriptors (i.e., attributes) for each domain attribute; and the 

TemporalDomain Wrapper class provides accessor and mutator (get and set) methods 
for these attributes. The wrapper also may declare one or more domain methods, 
which can have any signature to be invoked with the data item as the target object. 
The wrapper is a convenience class for accessing domain attributes, providing 

15 optional default values, and invoking domain methods through Java reflection. 

Analyzing any domain yields a list of attributes and methods. Though much 
like a class definition in form, Domain Policies are supposed to convey and define 
logically independent characteristics related only by their domain context. It is very 
important not to fall into the trap of accidentally creating a domain that reflects a 

20 particular class or interface, or to add implementation-specific details that have 

nothing to do with conceptual domains into a given Domain Policy. An application 
can obtain and manipulate attributes of an object via a domain wrapper instead of 
accessing the object directly. This eliminates the dependency on the class of the 
object. An application can now be written with only the knowledge of domains. No 

25 prior knowledge of a particular data source is required at development time, only 
domains. 
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In one embodiment, attribute aliases may be used. This enables one attribute 
to be substituted for another. This is typically used when two domains are defined 
that have similar attributes. This enables a consumer to ask for the Attribute from the 
domain that it knows about, and have the value translated from the Attribute of the 
5 DSI from the second domain. In one embodiment, the mediation layer implements 
this in a seamless operation, i.e., either the consumer or provider of the Attributes 
knows that it was an aliased Attribute, for example, "speed in knots" and "velocity in 
meters/sec". 

In another embodiment, methods of Domains may be registered with domain 

10 method descriptor factories similar to AttributeDescriptors. In this implementation, it 
enables developers to reference domain methods via these static singletons, determine 
if domain methods of interest are defined, and to determine all information about the 
argument types and interpretation of the domain method. Furthermore, like the 
attribute descriptor factory (AttributeDescriptorFactory), developers pass the 

15 necessary ingredients or information to this factory, and the factory handles the 
internal registration of the method parameter types, return type, exceptions, and 
interpretation. It ensures that one and only one object in the Java runtime exists for 
each distinct domain method definition (each unique method signature), similar to 
attributes and attributes factory. 

20 Figure 4 shows a schematic diagram of information that may be exposed by a 

data item 510 (440 and 452 in Figure 4). In an embodiment of the present invention, 
a data item 5 10 is defined as any unit of information that can be represented by a 
single object (perhaps containing subobjects) in an object oriented programming 
(OOP) language and is a coherent unit in terms of the semantics of the content domain 

25 that it relates to. Thus, data items are defined within a common semantic 

representation. Each information element is defined in terms of entities (data source 
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or data consumer component), identity, relationships, attributes (name/value), services 
(not just data), and change events (dynamic nature). 

For example, a single row in a relational database containing information on a 
person's name and address constitutes an information element, but so would the table 
5 from which it comes, and even the entire database itself. Different levels or 

granularity of information is useful in the context of different applications, but any 
one of them can be considered an information element for purposes of our exposition. 
An example of a noncoherent unit would be a random collection of name/address 
rows from a database, unless there was some comprehensible unifying characteristic 

10 to them (e.g., all rows for addresses in the state of Utah). 

Data items use Domain Policy attributes and methods to express the data item 
characteristics in a "normalized 11 manner. That is, a data item may expose Domain 
Policy methods 512, which are the functions or methods 516, 518, 520 of a particular - 
Domain Policy to characterize the data item's behavior and attributes to characterize 

15 the data item's information content. A data item may also expose Domain attributes 
and metadata. A data item may also be part of more than one Domain Policy, thus a 
number of Domain methods 512 may be exposed with such data item 510. The 
Domain methods define the method name, possible input parameters, which may be 
mutable objects, i.e., input/output parameters, and optional return value. This shows 

20 the expected behavior of the method, expectations of the inputs, and return value 

constraints. The data item may also expose one or more attributes 530 and 538. Each 
attribute 530, 538 may have an attribute value 534, 542, an attribute descriptor 532, 
540 (containing, among other information, an English text description of the 
attribute), and type metadata 536, 543. The type metadata may include the class type 

25 544 (the class type of the attribute's value) and type input/output 546 (TypelO, for IO 
facilities). Examples of class type are LatLonAlt (for latitude, longitude, altitude 
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data). String (string data), Integer (integer data), Date (calendar date), Color, and the 
like. TypelO, as discussed above, may indicate the input and output format. 

The Relationships 522, e.g., containment, hierarchies, and ad-hoc relationships, 
of a particular data item 510 may also be exposed as shown by the data items 524, 
5 526, 528. A data item may have zero (none at all) or may have many data 
relationships to the other data items via Domain methods and attributes. 

Additional information exposed by a data element is a metadata override, 
which may be used to override a default behavior of a Domain Policy attribute. For 
example, default formatting of a date for some Domain Policy may be overridden, 
10 from MM-DD format (two digits for month and two digits for date) to "month text 
string" and DD format. In one embodiment, this may be implemented by assigning 
different metadata to an attribute using FieldMetaData within the XIS framework. 

User Interface 

Figures 6A to 6F are exemplary representations of computer display windows 
15 produced by data consumer components 122, which may be developed within the XIS 
framework 100. These data consumer components may use any data source 
component 102 for data and may also be run without an associated data source 
component. 

Figure 6A shows a computer display window called "Map View 1" produced 
20 by a mapping program for an INFOBEAN object that contains vector shoreline data 
from a data source component to produce the world shoreline depiction in the drawing 
figure. If an appropriate data source is loaded into this INFOBEAN, then appropriate 
additional pieces of information will be displayed, e.g., as geographic points on the 
depicted world map. Appropriate pieces of information for this INFOBEAN may 
25 include numeric data, which may, for example, be mapped to a set of latitude, 
longitude, and altitude coordinates on the map display of Figure 6A. 
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Figures 6B to 6D show window displays of a file manager or information 
exploring component, much like a file system explorer, called "XIS Explorer" with a 
vertically oriented directory frame on the left side of the window display and two 
stacked information detail frames on the right side. The directory frame on the left 
5 may provide a tree diagram of available DSI components and their relationships to 
other components. Figure 6B shows that the Explorer View display does not contain 
any data (the "Explorer Contents" menu is empty). Figure 6C shows the XIS 
Explorer program after it is loaded with data called "Orders", "Computer", and 
"People Source" data sources, with "People Source" selected. Detail information 

10 about the People Source data is shown in the two stacked right frames. The upper 
right frame shows a listing of data objects or entries in the People Source data source, 
and the lower right frame shows attributes of a particular data object in People 
Source. A different set of data objects or records is shown in Figure 6D, this time for 
the "Orders" data file. That is, Figure 6D corresponds to the Figure 6B display after 

15 XIS Explorer is loaded with the "Orders" data. Thus, detail information about the 

orders is shown in the two right frames. Figure 6D shows that a listing of data object 
names can be provided in the left tree diagram frame. As indicated by the display 
windows shown in Figures 6B to 6D, the same data consumer component or 
INFOBEAN-generated display format (Figure 6B) may be used to display different 

20 data source components (Figure 6C and Figure 6D, e.g., "People Source" and 
"Orders"). 

Figures 6E and 6F show a graphing program ESFFOBEAN display. Figure 6E 
shows the window display when it does not contain any data, while Figure 6F shows 
"Orders" (the same class of data objects shown in Figure 6D) loaded and displayed as 
25 a graph. This shows that the same data source component 102 may be utilized by 
more than one data consumer component to display different types of data 
characteristics and carry out different operations on the data, as shown in Figures 6B 

46 



WO 02/46916 



PCT/US01/48418 



through 6F. Thus, different INFOBEAN data consumer components can be 
configured to produce the desired data operations and window displays from available 
data objects (sources). 

Figure 7 shows a computer window display for an INFOBEAN data consumer 
5 component, showing the property sheet of a particular data source object called 
"Person." This "Person" object may be a Java object. Those skilled in the art will 
understand that JavaBeans are a specification developed by Sun Microsystems that 
defines how Java objects can interact. An object that conforms to this specification is 
called a JavaBean. This object may be used by any application that understands the 

10 JavaBeans format. For example, the "INFOBEAN" objects available from Polexis, 
Inc. of San Diego, California, USA are objects that behave as JavaBeans that can 
process data in a generic fashion, looking for and manipulating data pertaining to 
particular domains as generated by DSIs or other INFOBEANs. 

Data consumer objects may also be Java objects that present and/or process 2D 

15 and 3D maps, table/spreadsheet data, hierarchies (trees), plots (bar, scatter, pie, etc.), 
gantt/timeline, content (e.g., email), organization charts, calendars, properties or 
attributes, and the like. 

Figure 8 shows a unified modeling language (UML) class diagram for a Person 
class source data. Using the XIS framework of the present invention, the data 

20 consumer, an INFOBEAN, obtains information, particularly, the attributes listed in 
Figure 7 (e.g., SSN, Display Name, DOB, and Name) of the Person object. This set 
of information is shown in blocks 460 and 461 in Figure 4. This is performed, for 
example, by using a naming convention for methods, i.e., GET + "Attribute Name." 
An API determines the available methods of an object and determines attributes based 

25 on method names. For example, an API from "getDOB," "getName," and "getSSN" 
methods determines the attributes DOB, Name, and SSN, respectively. Java 
introspection may also be used. 
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Figure 9 shows the different attributes obtained or exposed for the Person 
object (i.e., DOB, SSN, and Name). In addition, using the toString() method, 
available for every object in Java, as shown in Figure 6, the DisplayName attribute is 
also exposed. 

5 In one embodiment, no Translator exists for the Person object. Also, there are 

no static get<PropertyName>Descriptor methods defined, so the only XIS Domain 
Attribute is the displayName that is obtained, by default, from the toString() method 
available in every object in Java. The remaining attributes (date of birth, Social 
Security number, and name), though not mapped to a Domain, are available through 

10 the mediation layer API. 

If an XIS Translator were used or if the Person class specified XIS 
AttributeDescriptors, then the Java fields could be mapped to domains. In this case, 
for example, the birth date and Social Security number could be mapped to 
corresponding attributes in the "Personnel Domain". Within this domain, the 

15 attributes would be specified with detailed TypeMetaData, which is made available so 
that the data from the attributes, such as the Social Security number, can be 
appropriately validated, displayed, edited, formatted, and otherwise processed 
wherever that attribute is used. 

Figure 10 shows how an object, particularly a data source component, may 

20 belong to multiple domain policies. In this case, for example, the domain policies 
include the Geo Domain (geographical domain), Movement Domain, and Display 
Domain. The Geo Domain has defined at least two methods called GetLatLonAlt and 
SetLatLonAlt. The GetLatLonAlt method obtains the latitude, longitude, and altitude, 
while the SetLatLonAlt method sets these parameters. The Movement Domain 

25 contains a GetCourse method, which obtains the course or direction of an airplane, for 
example. The Display Domain has two methods called GetDisplayName and 
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GetBrushColor, which obtain the name of the object and display the color of the 
object, respectively. 

Figure 1 1 shows a sequence diagram of a domain policy usage scenario. In 
this time sequence diagram, each column represents an entity (i.e., user display 1 102, 
5 data consumer component 1 104, and data source component 1 106), and time or 
sequence flows from top to bottom. Here, a data consumer software component 
(middle) requests a data source to tell it the Domain Policies to which the data source 
subscribes. Upon receipt of the information, the data consumer checks to see whether 
these include the Geo, Movement, and Temporal Domains, which it recognizes. The 

10 developer of the data consumer need not have known about this particular source, nor 
the data source developer known about the particular consumer, for these two 
components to interoperate correctly: the data consumer plots three numbers given to 
it by the source as position, speed, and a time duration (computed by a call to a known 
function on the source), as they were intended by the source's developer. In the XIS 

15 framework, applications and components that comply with the Domain Policy API are 
able to share data in a simple yet powerful manner, ensuring automated integration 
and reuse. Thus, data sources and data consumers may be independently developed. 

In one embodiment, attributes of a given domain are exposed through the static 
final AttributeDescriptors of that domain. The AttributeDescriptors that make up any 

20 given domain are built using the AttributeDescriptorFactory. If the developer of a 
data item class uses a custom AttributeDescriptor, then it should be built (typically in 
the Translator) using this factory. 

Table VII below shows exemplary code that illustrates how a DisplayDomain 
builds its font attribute. 



Table VII 
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public static final AttributeDescriptor font; 
static { 

AttributeDescriptor tmpFont = null; 
try { 

AttributeDescriptorFactory factory = 

AliributeDescriptorFactory.getAt1xibuteDescriptorFactory(); 
tmpFont = factory xreateAttributeDescriptor( 

"font", 

DisplayDomain . class, 

new com.xis.types.FontTypeMetaData('Tont") 

); 

} catch (Throwable t) { 
t.printStackTrace(); 

} 

font = tmpFont; 



Providing the font parameter to the factory means that the expected method 
names for accessing the attribute will be getFontQ and setFontO- The exception is 
5 thrown if the attribute has already been registered with that domain. The primary 
integral ingredient of an AttributeDescriptor is the appropriate TypeMetaData. 

Figures 12A to 12D list an exemplary Java package called com.xis.types and 
its respective classes. In one embodiment of the invention, several packages 
containing various classes to implement the features of the present invention are 
10 contained in class libraries or APIs. 
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Referring again to Figures 2 and 4, the set of Relationships 210, 472, 473 that a 
given data item 440, 442 possesses with other data items is also exposed through 
standard method calls. One method retrieves the "member elements" belonging to a 
given element in a parent-child relationship. These members are directly referred to 
5 by means of conventional object "pointers". 

Figure 13 is a block diagram representation of how relationships between data 
items within the XIS framework 1 00 are exposed in a generic fashion. Member-of 
(i.e., hierarchical) and reference relationships are supported. 

Members enable the creation of a hierarchical data structure. A data source 

10 object may also have members themselves. When members are added or removed, it 
is the data source's responsibility to fire the appropriate events to inform any listeners 
that the data structure has changed. By nature, certain objects have members (like 
Collections or arrays). In one embodiment, the actual array is returned to the object 
requesting the relationship. 

15 A reference represents a pointer or a reference to an object. In one 

embodiment, an object may be referred to without instantiating that object until 
necessary. References in the XIS framework may also provide persistable or 
persistent data to define a link and may also refer to software classes/objects on how 
to later resolve such link to an actual live data item. These references may also 

20 provide annotations (e.g., description of links and their roles with respect to data 
items). 

Figure 14 shows how references may be resolved. Information regarding 
relationships, as stated above, may be obtained using object pointers, e.g., there is an 
object pointer from one data item to another data item to indicate a parent-child 
25 relationship. In this way, data source components may be able to determine which 
data items are directly or indirectly children of which others and the general 
relationships between data items. This set of relationship information may be used in 
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displaying and representing the data items with its own characteristic fashion. This 
relationship information, for example, may be helpfiil in an organization chart or an 
explorer-type consumer component. Relationships, for example, may be a "peer-to- 
peer" or "members of type. 
5 In Figure 13, for example, a data consumer Component A 1320 requests the 

relationship of a data source component 1313 (Source 1), via the mediation layer 112 
shown in Figure 1. Via the same mediation layer 1 12, the data source component 
(Source 1) 1313 returns a data item, which indicates the relationship of the data 
source component or data item, as shown in Source 1 1315. Similarly, the same data 

10 consumer Component A 1320 may request the relationship of data source component 
1330 (Source 2), and such relationship information is returned 1325. Another data 
consumer Component B 1340 may also obtain the relationship information of the data 
source (Source 2) 1330, i.e., the result 1335. As shown, the resulting relationship 
information 1325 and 1335, e.g., how the relationship is represented may depend on 

15 the data source component, for example, the relationship information shown in the 
box 1325 is different from the box 1335. 

In one embodiment of the invention, a unique ID for a data item is available in 
the current runtime environment. Such unique ID for a particular item need not be 
recreated (or a new unique ID created) except when the data has been completely 

20 unloaded and then reloaded, e.g., loading of a row from a database, unloading it, and 
then reloading (will usually result in a new unique ID). 

A second method retrieves links representing a more general and indirect form 
of relationship comprising a text annotation and a reference object which can be used 
to either obtain the referred data item (or information element) or retrieve or 

25 reconstruct it if it is not directly available. This retrieval or reconstruction need not 
take place until the moment the referred information or data element is actually 
needed. In particular, the reference refers directly to a "resolver" object on which— 
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when retrieval is actually requested— a method is called with arguments also specified 
in the reference. This method then returns the desired information element or data 
element. 

This mechanism is quite general; one possible implementation would be a 
5 resolver object able to make queries on a database and construct data source objects 
from the result. The reference could specify the particular query to be made, with the 
effect that a very small reference (comprised primarily of a query string, assuming the 
resolver class is loaded as part of the general mechanisms within the application) can 
be passed around between application components and only resolved into a large, 

10 memory intensive data object when some operation (such as display to a user) needs 
to be performed on it. Other types of reference retrieval mechanisms not involving 
databases are possible, such as query of network based services or collection of direct 
user input, i.e., anything that can be implemented within the implementation language 
can be used as a reconstruction procedure. 

15 Additional methods on a data element may be implemented to provide 

Relationship information in the reverse direction ,that is, to the elements that contain a 
given element and elements that refer to a given element may also be acquired 
through direct queries. 

Finally, a more dynamic form of information is accessible through a 

20 standardized mechanism by which interested data consumers 122 or sources 102 can 
register— through calling a particular method on the data source object 102— to receive 
events whenever one or more chosen aspects of a data source change. In particular, a 
data source maintains lists of those software objects interested in hearing about 
changes in attribute values, the addition or removal of attributes, the addition or 

25 removal of members or containers, and the addition and removal of references or 
referrers, and whenever one of these aspects changes, it sends a message to each 
object on the appropriate list. This mechanism, founded on the event passing 
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mechanisms found in many object oriented programming languages and libraries but 
centered around information structure as exposed generically within the XIS 
framework, enables different components of an application to "keep in sync" with 
information sources that change or grow during use. In other words, if a data source 
5 signals a change in an information element, all displays and computations can be 
updated immediately to reflect the change, much like a dynamically adjusting 
spreadsheet program. 

Figure 14 is an exemplary flow diagram that shows how a reference is resolved 
within an XIS framework. In the first block 1410, a data consumer component 

10 Consumer A produces or creates a reference to a data item Data X. In the next 
operation 1420, this reference is saved to disk, e.g., as a text file. In the next 
operation 1430, the data consumer component Consumer A is restarted and the 
reference is retrieved from the file saved in the previous operation. In the next 
operation 1440, such reference is also passed to data consumers Consumer B and 

15 Consumer C. Next, at 1450, Consumer B requests resolution of the reference. This 
resolution is done in the next operation 1460, wherein Data X is constructed through 
executing a database query. This database query is stored as part of the reference 
information stored in the disk (block 1420). The query returns the data item Data X, 
which is then used by Consumer B (block 1470). Consumer C may also request 

20 resolution of the reference (block 1480). Considering that data item X has been 

resolved by the data consumer component Consumer B, Data X is not reconstructed 
again from the database, rather a cached yersion is directly returned instead (block 
1490). This operation 1490 assumes that no change in Data X occurred. 
In one embodiment of the invention, the XIS framework models 

25 communication after the JavaBeans Property Change mechanism. Figures 36 A to 36B 
show a listing of an exemplary package, com.xis.leif.event, which includes interfaces, 
event objects, and default implementation adapters for events in the XIS framework. 
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The UML sequence diagram shown in Figure 36C shows how a data source 
interacts with an INFOBEAN. In particular, it shows how a data source and an 
INFOBEAN interact when data is added. The INFOBEAN gets a LeifDataltem for 
that object and adds a listener. When the data source updates the object, or if any 
other INFOBEAN updates the LeifDataltem, the LeifDataltem fires events to all 
listeners. 

Each INFOBEAN may choose to listen for changes in the data it is using. If it 
would like to receive updates, it must attach a LeifDataltemListener to each data item 
to which it would like to listen. Thus, when something changes in the data, the 
listener receives the event. Upon receiving this event, the listener updates the 
corresponding data item if the change is one that concerns the INFOBEAN. 

Figure 36D shows a UML sequence illustrating how a data source and 
INFOBEAN interact particularly when data are updated. 

In one embodiment, state attributes are defined to assist in determining change 
events as well as management of references. The state attribute describes what state 
the data is in at any time. This may be implemented to determine whether a data item 
should be kept and whether to display it, for example, without listening to the parent 
of the data, if there is one. Exemplary states are defined below: 

(1) Deleted: When a raw data item is in this state, it is no longer 
being used and should be discarded. 

(2) Exists: When a raw data item is in this state, the data exists and 
is still being referenced as either a member of another raw data 
item or it is a DSI itself. 

(3) Live: This state includes everything in the Exists state. This 
state also means that the data item is also connected to a live data 
feed such as a database or server and that the connection is still 
alive. 
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(4) Dead: This state includes everything in the Exists state. This 

state also means that the data item was, at one point, connected to 
a live data feed, but the connection to the data feed no longer 
exists. An example of a Dead state is when the connection to a 
5 data server goes down and the data still exists in the DSI, but can 

no longer be updated. 
To better help understand the features of the invention, sample information- 
handling applications, using Java programming, are exemplified and discussed below. 
Example 1 

10 Figures 15 and 16 show two Java source files to implement an application 

within the XIS framework. The output is shown in Figure 17. 

Figure 15 lists the HelloWorld.java source file that creates a HelloWorld 
object, which is a data source component. This source file is a minimal Java object 
that satisfies the method conventions for a JavaBean, in this case, it contains "get" and 

15 "set" methods (which often but need not necessarily correspond to private member 
variables), and a toStringQ method. 

Figures 16A and 16B list the TestHarness.java source file that creates a 
TestHarness object, which is a data consumer component. TestHarness contains all 
the code to access all the information exposed within XIS and display its 

20 properties/attributes using a PropertySheetlnfoBean. The PropertySheetlnfoBean is a 
data consumer component, which displays the attributes of a data source component. 

Referring back to Figure 16A, as shown in the portion of code 1602, many 
standard classes of the Java language are used. In addition, a set of classes provided 
within the XIS framework, particularly within the mediation layer, is also used, e.g., 

25 com.xis.leif.im.BaselnfoModel. The code for the class library for the com.xis.leif 
class is not shown herein. Various alternatives relating to what classes are needed 
would depend on how the XIS framework of the present invention is implemented, 
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designed, and the like, as will be known to those skilled in the art in view of this 
description. 

The first line in main() of the HellbWorldjava code 1604 prevents the XIS 
PluglnManager from starting up. The PluglnManager is used for tying components of 

5 a large XIS application together based on resource files it finds associated with their 
classes. The PluglnManager is further discussed below. This feature is set to "off ' to 
reduce the time to startup. 

The lines of code shown 1606 in the first part of this source file sets up a 
predefined XIS InfoBean, in this case, PropertySheetlnfoBean that is capable of 

10 displaying the available attributes of an object. The attributes are obtained through 
the Java language reflection method, which are used to make a wrapper object in the 
addRawDataltemQ call. This means that the addRawDataltem method in the 
"properties" class is predefined within the XIS framework. This addRawDataltem 
method will ultimately result in the invocation of the reflection feature of Java so that 

15 the various attributes contained in the data source HelloWorld object are exposed to 
be used by the PropertySheetlnfo. 

The PropertySheetlnfoBean uses the wrapper to access the attributes for 
display and, if necessary, enable the user to update the exposed attributes of the 
object. In this example, however, none of the attributes are editable. The 

20 PropertySheetlnfoBean also fires a close event when a "Cancel," "OK," or close 
button is pressed. The next portion of code 1608 sets up a Java listener to exit the 
program when the appropriate button is pressed. 

The last portion of code 161 OA and 161 0B creates a JFrame (Java frame) to 
display the INFOBEAN (it extends java.awt. Component). A listener is added to exit 

25 the program when the window is closed. 

Figure 17 shows the resulting display application on INFOBEAN called 
PropertySheetlnfoBean. Example 1 is very simple, as it simply displays the attributes 
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exposed for the HelloWorld object in a tabular format. Pressing a "close window" 
display button causes the application to exit. 
Example 2 

Figures 18 A, 18B, 19A, and 19B list two Java source files. These two Java 
5 source files function similarly to those listed in Figures 15 and 16. Modifications or 
additions to the code listed in Figures 15 and 16 are marked with "/*{*/" <new code 
here> "/*}*/} The resulting output is shown in Figure 20. 

Figures 18A and 18B extend the previous HelloWorld class (Figure 15) by 
using the JavaBean standard property change event distribution classes so that other 
10 XIS objects are automatically notified when its properties are changed (within the set 
methods). The java.beans.PropertyChangeSupport instance takes care of maintaining 
lists of listeners and sending events to them. It is only necessary to implement 
wrapper methods to pass listeners to this contained instance (the first block of new 
code after the imports 1 802) and then to call the fireProperty Change method 1804 on 
15 it when anything is actually changed. This is performed in the setValue 1808 and 
setMyColor 1810 methods. Value and My Color are editable fields. 

Figures 19A and 19B contain the TestHarness file. Similar to Figures 16A and 
16B, the TestHarness file contains code to expose an instance of this object within 
XIS. In this case, not only are the properties or attributes displayed using a 
20 PropertySheetlnfoBean, but a charting program, ChartlnfoBean, i.e., another data 
consumer component uses the same data item to display a chart accordingly. The 
ChartlnfoBean automatically searches for numeric attributes on the data item and 
plots them accordingly. The Numeric attributes are recognized as such through 
reflection when the raw data item, HelloWorld object, is wrapped within a 
25 LeifDataltem object. 

Similar to Figures 16A and 16B, the TestHarness file contains code to expose 
an instance of this object within XIS. In this case, not only are the properties or 
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attributes displayed using a Property SheetlnfoBean, but a charting program, 
ChartlnfoBean, i.e., a data consumer component feeds the same data item to display a 
chart accordingly. The ChartlnfoBean automatically searches for numeric attributes 
on the data item, and allow them to be plotted. The Numeric attributes are recognized 
5 as such through reflection when the HelloWorld object was registered within the XI S 
framework. 

The first portion of code 1902 sets up a property sheet INFOBEAN similar to 
Example 1. The second new code portion 1904, marked in the drawing by comment 
braces, sets up a second frame and puts a ChartENFOBEAN into it. Since the chart 
10 can display multiple data items, the method to feed it data items (addRawDataltems) 
1906 takes an array of objects. The method setChartType 1908 may be used to 
specify the type of chart, its axes, and so on. 

Figure 20 shows the PropertySheetlnfoBean displaying the attributes of the 
data item, i.e., the HelloWorld object. The charting component is not shown in the 
15 figure. 

Example 2 application puts up two windows— a property sheet displaying 
information on a HelloWorld object and a chart display (alternatively called a "plot" 
display) showing one or more of the numeric attributes of the same data item. On the 
property sheet, editable fields are surrounded by a darker gray background. In 

20 particular, one may change the "My Color" property by clicking on it. Clicking on 
this property brings up a default editor for color attributes defined within this 
framework. In this embodiment, numbers, strings, dates, and several other kinds of 
attributes all have appropriate editors automatically set up for them within XIS, via 
the TypeMetaData facilities. 

25 The chart starts out displaying either the ID or the Value attribute. It may be 

changed by clicking on the Y axis label. This is also the way to set which kind of 
chart (bar, line, pie, etc.) is used. If the value being plotted (or the color) is changed 
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in the property sheet (and the display button "Apply" is pressed), the chart 
automatically updates. Similarly, right clicking on the part of the chart corresponding 
to a data item enables a user to bring up its property sheet. In this embodiment, this 
kind of coordination is maintained automatically within the XIS framework through 
the use of the JavaBeans event mechanisms. It should be noted that when the 
application is run or executed, the color of the chart does not match the one set in the 
property sheet. This is because, although the PropertySheet recognizes that any field 
of type "java.awt.Color" is displayable and editable as a color, the chart has no way of 
knowing which color field (if there are more than one) should be used. This may be 
solved, however, within the framework by using standardized Domain Attributes. 

In one embodiment of the invention, Translators are used within the XIS 
framework. As described earlier, a DSI exposes data information within the XIS 
framework for data consumers to use. Java reflection and introspection may be used 
to obtain attributes specified in simple objects and JavaBean, respectively. The XIS 
framework first searches for a Translator class for the data source object. Translators 
are therefore optional considering that the attribute values and attribute descriptors 
may directly be obtained from an object. Translators may also be used in order to 
keep the object's class simple so that it is capable of being used in non-XIS 
environments. 

In an embodiment, Translators are somewhat similar to the Beanlnfo class in 
JavaBeans. Like the Beanlnfo class, the name of the class must begin with the name 
of the data class followed by "Translator". For example, a DSI class named 
PlanObjectjava would have a corresponding Translator class 

PlanObjectTranslator.java. Also, similar to Beanlnfo classes, Translators must reside 
in the same class space in which the DSI is located. For special circumstance cases 
such as non-localized objects or custom Translator definitions, a Translator registry, 
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5 



e.g., TranslatorRegistry, may be used to register a Translator for a given data item 
class. 

Table VIII below shows an exemplary code to register a Translator within the 
XIS framework. 



Table VIII 



// register the translator for File objects 
TranslatorRegistry.getTranslatorRegistry() 

.registerObj ect S chema(PlanObj ect. class, 

PlanObjectTranslator.class); 



The above code, as well as all code discussed herein, is provided to illustrate 
the functional behavior described herein. One of ordinary skill in the art will be able 

10 to produce the code, for example, to create classes, objects, APIs to affect this 
Translator registry. 

When the value of an attribute is requested from a data source component, 
using the mediation layer, the value from the attribute methods specified in the 
Translator, if any, is exposed. If the Translator does not exist, then the method in the 

15 object is invoked, i.e., the get+attribute method within the data source object. The 
Translator may directly invoke the object's methods as well. The Translator may also 
be used to wrap legacy code. For example, if the object class is a legacy code, which 
may not be modified, and has a color property, a Translator may be written to return 
the value of the color, for example, for the DisplayDomain.color attribute. In this 

20 way, the information may be accessed without modifying the original legacy code. 
The data in the data source object in effect has been normalized or tailored to the 
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domain policy specified. The XIS framework in this embodiment provides the ability 
to integrate existing data item classes without modifying them. 

To integrate a data item class into the XIS framework, an accompanying 
Translator class should be provided. In this Translator class, the data source 
developer provides code that reaches back into the data item's class to expose its 
properties. It also serves as a way of normalizing access to these properties by 
imposing a common interface for all Translators to implement. 

Translators have two primary functions: 

(1) Translators provide an intermediate method from the caller of an attribute 
"get" or "set" method to the data source object, enabling a developer to translate the 
value from its internal representation to a representation understood within the 
framework, particularly, by the data consumer components. For example, an object 
may store a default color as a string color name, but the Translator may convert that 
color to a java.awt.Color object. 

(2) Translators also enable a developer to define attribute types more precisely 
(e.g., via AttributeDescriptor code, which provides detailed TypeMetaData and may 
map attributes to specific domains). This resolves any ambiguity in the attribute type. 
It should be noted that reflected properties that are converted into XIS attributes carry 
minimal semantics, which contributes to the usefulness of the XIS framework. For 
example, "float getDegrees()" by itself does not imply whether it provides an angular 
measure or a temperature measure, nor does it imply that the valid range is from 0 to 
360 or from 0.0 to 2.0 pi for angular measures, or distinguish between Fahrenheit, 
Celsius, or Kelvin for temperature measures. 

Translators also enable developers to convert objects that do not follow the 
JavaBeans get/set API design pattern. For instance, a data item could be implemented 
as a mapping of attribute names to values (e.g., String, Integer, Double, and Boolean). 
The Translator may map actual XIS attributes to these key/value combinations, 
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making XIS data items appear as if they were generated from the more typical 
JavaBeans-style objects. Example 3 shows how a Translator may be implemented in 
the XIS framework. 
Example 3 

5 Example 3 application is contained in three source files listed in Figures 21, 

22A, 22B, 22C, 23A, 23B, 23C, and 23D. The resulting outputs are shown in Figures 
24Aand24B. 

Example 3 functions similarly to Example 2 above, but enable finer control 
over the data item attributes exposed within XIS. In particular, the HelloWorld object 

10 is explicitly wrapped in a Translator rather than simply feeding it to XIS and letting it 
rely on reflection to display and manipulate the data. This allows some properties of 
the raw data item to be hidden, and allows other ones to be better "understood" within 
XIS. The Hello WorldTranslator Java file contains the Translator. 

Referring to Figure 21, the property change event-handling portion of code 

15 1506 found in Figure 18A has been removed from the set methods. These functions 
are now handled in the Hello WorldTranslator class (Figures 22A-22C), which is 
registered with XIS by the TranslatorRegistry static call at the beginning of that class. 

Referring to Figures 22A to 22C, this file contains the HelloWorldTranslator 
class 2202 that wraps the HelloWorld object. When an INFOBEAN encounters a raw 

20 data item, it ultimately accesses the raw data item through a Translator's methods, if a 
Translator exists. In one embodiment, all Translators are subclasses of the 
com.xis.leif.im.Translator class, which provides an infrastructure that facilitates the 
use of attributes already defined or set-up in an XIS Domain. Such attributes have 
type metadata predefined for them, and many XIS INFOBEANs automatically access 

25 and utilize the metadata and the attributes themselves. 

The first member variable 2204 of the HelloWorldTranslator class lists the 
predefined XIS domains from which attributes are taken. In order to use an attribute 
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not in one of these domains, it may be necessary to provide a separate metadata for it. 
The second member variable 2203 defines an array, which lists auxiliary information 
on the fields, in this case, whether they are displayed by default in the property sheet 
display. The getFieldMetaDataArray method 2206A and 2206B fills this array, if 
5 necessary, with the default metadata for the fields that are exposed by the get and set 
methods further listed below in the source file. The exception to the defaults is that 
the "course" attribute 2208 is not visible, i.e., it is not displayed under the "Preferred 
Attributes" on the property sheet. It is displayed, however, when the "All Attributes" 
option is selected. Other things that may be set (but are not in the source file) include 
10 the sorting order and rank when multiple data items of this class are listed together, as 
in a table. 

The ensuing get and set methods 2210 define the attributes that the rest of the, 
XIS objects can see. In general, this refers to the enclosing raw data object, but this 
need not always be the case. For example, here, the HelloWorld's integer Value 1 

15 property is map to the 'speed' attribute, which takes its metadata and its type (double) 
from the Movement domain 2212. The Movement domain has previously been 
defined. By handling conversions within the Translator, the rest of XIS "never 
knows" that there is really an integer value underneath. 

All change event propagation is handled through the request objects passed 

20 into the set methods 2214. Similar to Example 2, all XIS objects using the same data 
item are notified of the change. 

Referring to Figures 23A through 23D, the TestHarness code is largely 
unchanged from Example 2, but at the end it includes a separate class that 
demonstrates how attributes may be altered on a data item that includes a Translator. 

25 In general, the procedure is to obtain, first, the LeifDataltem corresponding to the raw 
data item, then a "domain wrapper" that wraps this and enables access to attributes 
that come under that domain. Internally, the domain wrapper calls methods on the 
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Translator, but externally it presents an interface to the developer that depends only 
on the domain and not on the particular LeifDataltem being wrapped. 

The code in the Accelerate class is a standard thread implementation that uses 
the wrapper to successively change the Hello World data item's speed attribute. In 
5 other embodiments, this attribute may be altered by any portion of the program that 
has access to the data item. Because the wrapper eventually calls the Translator, the 
change events are propagated appropriately. 

The Example 3 application, similar to Example 2, displays two windows— a 
property sheet and a chart. Example 3 shows that the property sheet may be made to 
10 display more properties (in this case, the "course" attribute) by selecting "All 
Attributes" from the top menu, which ignores the "preferred" setting in the 
FieldMetaData. The attributes all have reasonable names, which come from the 
metadata stored in the domains. Finally, if the "Pen Color" attribute is edited, the plot 
changes color accordingly. This is because the Chart INFOBEAN recognizes and 
15 uses the "Pen Color" attribute from the Display Domain if it finds one on the data 
item. Because of the various wrappers employed, it does not matter what kind of 
object is eventually underneath or what other attributes it has; as long as the "Pen 
Color" attribute is found, it will be used. 

Example 4 

20 Example 4 contains two source files namely Hello World and TestHarness. 

Figures 25A to 25C list the Hello World java source file. This example shows 
translation without a Translator class. The resulting output is a property sheet 
INFOBEAN and a Chart INFOBEAN. Figure 26 shows the property sheet InfoBean, 
but the ChartlNFOBEAN is not shown. The HelloWorldTranslator.java file from 

25 Example 3 is eliminated. Similar to above, the HelloWorld.java file has been marked 
such that changes from Example 3 are marked by open and close commented braces. 
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The Java source files enable some of the same fine control over the attributes 
exposed within XI S (see Example 3) without using a separate Translator class. If a 
developer has control over the Java code for the data source, the overhead of using a 
Translator may be eliminated by building some of its functions directly into the data 
5 source. It may, however, still be desirable to use a Translator because this avoids 
building any XlS-specific code into the JavaBean created and enables the code to be 
more streamlined for use in non-XIS contexts. 

Figures 22A to 22C contain the HelloWorld code, which include some of the 
code from Example 3, with some additional code for exposing attributes and > 

10 providing field metadata as the HelloWorldTranslator class in Example 3. In fact, 
almost everything may be done from within this data item class that could be done 
with a Translator except for two things. First, attributes cannot be hidden from XIS-- 
everything with a get() method is exposed. Second, Translators may be used in 
conjunction with security features, for example, embodied in the XI S framework to 

15 restrict access to visible properties in a generalized fashion across all data items. 

The first portion of code 2502 provides methods for XIS to obtain information 
on which data item properties have attribute information provided for them. The XIS 
components first introspect on the data item to find its properties, then try to call the 
get(property name)Descriptor for each property. For those instances where this fails, 

20 the XIS component may provide its own attribute descriptors where it recognizes the 
type of the attribute. For example, the property sheet recognizes Color, Numeric 
(various subtypes), Date, and String attributes. The next portion of code 2504 
initializes a PropertyChangeSupport instance, because property change events must be 
handled here, similar to Example 2. 

25 Following this are several methods unchanged from Example 3, but the set() 

methods have been altered to resemble those from Example 2 in which property 
change events are fired. Next, there are several new get() and set() methods which 
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expose the properties with the same names as the Translator did in Example 3. These 
names correspond with the getAttributeDescriptor methods listed above in the code, 
and the XIS components interpret them accordingly. These properties show up as 
preferred attributes in the property sheet, whereas those properties without 
corresponding attribute descriptors become nonpreferred attributes. 

The portion of new code 2506 following this provides field metadata for this 
raw data item. This program code is almost identical with those in the Example 3 
HelloWorldTranslator, except that both the variable and the method are now static, 
and the "Course" attribute removed to reduce clutter. 

The TestHarness file for Example 4 is generally unchanged from Example 3, 
except the code to register a Translator is removed. The portion of program code 
2302 in Figure 23 A is removed in this example. 

This Example 4 application is largely similar to Example 3, except that if the 
"All Attributes" option is chosen under the property sheet, then the previously 
unexposed "value", "myColor", and other attributes appear. The chart is also able to 
display the "value" and "ID" properties. 

Figure 26 shows a window display of the property sheet output from the 
Example 4 application. 

Processing Flow for Exposing Data 

Figure 27 A and Figure 27B show a flow diagram of how information about a 
data item, e.g., a data item as shown in Figure 5, is exposed to data consumer 
components. In the preferred embodiment, data exposure within the system may be 
accomplished by one of three methods, described further below. There are two 
primary functions to be performed: (1) interfacing with an internal or external data 
source such as a set of disk files, a database, or a web service; and (2) exposing the 
resulting data according to the standard interface outlined above, e.g., following the 
domain interface, relationships interface, and the like. 
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In the first method of exposure, one software component performs both 
functions; in the second method, separate software objects perform the two functions; 
in the third method, which is only implementable in an object oriented programming 
language that provides self-analysis facilities, such as Objective C or Java, the 
5 exposure function is performed automatically by the system. More particularly, in the 
first method, a data source interface (DSI) software object is written that connects to 
an external data source such as a local file system, an Internet site, or an RDBMS. 
The DSI object converts the information provided by the external data source into the 
information representation or data item that may be consumed by data consumer 

10 objects as described above. In a preferred embodiment of the invention, the data 
source DSI objects are from the LeifDataltem class. 

In the second method, the API of an existing software data object is accessed 
by a Translator object, which then exposes the information to other data consumers in 
the representation format discussed above. This arrangement is referred to in the 

15 object oriented design literature as an Adapter or Wrapper pattern. See, for example, 
Gamma, E., Helm, R., Johnson, R., Vlissides, J. (1995); Design Patterns: Elements of 
Reusable Object Oriented Software; New York: Addison-Wesley. This is generally 
referred to as "wrapping". More precisely, a data consumer component requests 
information from the Translator object, which then converts the request into 

20 something the original data source object can deal with. The consumer then converts 
that object's response into the appropriate format for a response to the original call. 

The third method applies the facilities within a self-analysis-capable 
programming language such as Java or Objective C. This type of programming 
language enables an object to determine the available data fields and function calls 

25 afforded by another object while an application is running. In the preferred 

embodiment implemented in Java, the queried object must be a "JavaBean" according 
to Sun Microsystem's suggested convention, with "get() lf and "setQ" method calls. 
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Each data field available through one of these calls, or by virtue of being a "public" 
variable, is examined, and the resulting type information is used to expose both the 
field's value and appropriate metadata to data consumers. If the field is a numeric 
type (double, Double, float, Float, Integer, int, long, or byte in Java), it is exposed as a 
5 decimal or integer with an "unknown" unit of measure. If the field is a string (String 
in Java), it is exposed as a text element. If the field is a complex object, it is exposed 
as a linked element via a reference (discussed above), unless a special class has 
registered to handle the complex object type within the application context or XI S 
framework. 

10 In another embodiment, in addition to the facilities for exposing data, the XIS 

framework provides an apparatus for allowing application context to affect how 
information is exposed. This is illustrated in Figures 27A, 27B, and 28, described 
further below. The attributes, methods, and relationships available for a given data 
source are determined by a surrounding structure called an InfoModel. The 

15 InfoModel connects the pieces of the XIS framework together. It is an interface 

comprising an object that knows how to return data item information. See also Figure 
3 A discussed above. 

In another preferred embodiment, an application comprises one or more Views, 
each containing and providing an InfoModel to one or more data consumers, termed 

20 INFOBEANS as described above, which may provide display, computational, or 

interactive facilities. All of the Views are in turn managed under a single ViewHost, 
which provides the global application context. Conceptually, a view represents a 
single perspective of the current data. One single perspective (or view) could be quite 
different from another because of the ability to add/override attributes in a view. 

25 View creates a new InfoModel that in turn creates new LeifDataltems that are used 
within that view. This is done to separate context sensitive attributes between an 
InfoModel and another View, INFOBEAN, or InfoModel. Views are also used as a 
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controller of one or more INFOBEANs by managing the data flow to each individual 
INFOBEAN. All Views are also by definition INFOBEANs since they manage 
information flow with generic means. The ViewHost is used to manage the complete 
set of Views and INFOBEANs, thus presenting each view to the user in a uniform 
5 fashion such as frames, windows or other display mechanisms. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. The 
diagrammed operations will occur when the XIS framework is loaded into program 
memory of a computer system that supports an object oriented programming (OOP) 

10 environment, as will be understood by those skilled in the art. In the first processing 
step, at block 2702, a data source object is registered within the XIS framework of the 
computer system. When a data item is brought into the framework, it is exposed to 
data consumer objects, e.g., via an InfoModel, typically via one of three methods. The 
first operation is to determine whether a Translator object is available and whether the 

15 Translator object is registered for the raw data object type. This processing is 
represented by the decision block 2704. 

If the Translator is available, an affirmative outcome at the block 2704, then at 
block 2760 the data item attributes, methods, and Domains are obtained via the 
Translator. If the Translator is not available, a negative outcome at 2704, then at 

20 block 2706 the data item object is scanned to find the data object's methods. The 
scanning may be accomplished with facilities of the OOP environment of the host 
computer system, such as InfoBeans. 

After the data item object has been scanned at block 2706, the system next 
checks to see if the data item includes an XlS-standard data exposure interface (that 

25 is, a predefined interface known to the XIS framework). If the standard interface is 
available, an affirmative outcome at block 2714, then at block 2762 the data item 
object attributes, methods, and Domains are obtained from the data source object 
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itself. The system then checks for references to Domain Policies at block 2763. If 
there is no standard interface available at the decision block 2714, then processing 
moves to the block 2764, where the facilities of the programming language of the 
OOP environment are used to interrogate the data item object to determine the object's 
5 accessible data fields. Processing then moves to exposure attribute processing via the 
off-page connector B to Figure 27B, described below. 

Returning to block 2762, after the data item attributes, methods, and Domains 
are obtained, a check is made for Domain Policy references at the decision block 
2763. If there are references to Domain Policies, an affirmative outcome at the 

10 decision block, then at block 2765 a check is made to determine if there is 

FieldMetaData override for a Domain. If there are no Domain overrides, then at 
block 2710 the definitions from the referenced Domain Policy are used for the 
attribute metadata. The processing then moves to exposure attribute processing via 
the off-page connector A. If there are Domain overrides, an affirmative outcome at 

15 block 2765, then at block 2716 the system uses the definitions included with the data 
item object Translator for the attribute metadata of the data item. The processing then 
moves to exposure attribute processing via the off-page connector A. Referring back 
to block 2763, if there were no references to Domain Policies, then processing 
proceeds straight to block 2716 to obtain the attribute metadata definitions and then to 

20 the exposure attribute processing via the off-page connector A to Figure 27B. 

Turning to the processing of Figure 27B via the off-page connector A, the data 
item attributes are exposed to the local InfoModel class (i.e., a DSI object). Next, at 
the decision block 2770, a check is made to determine if the data item has any 
dynamic attributes. If the data item does, then at block 2772 the framework 

25 processing adds the dynamic attributes to the available data item attributes. If the data 
item has no dynamic attributes, or after any dynamic attributes have been added, 
processing moves to block 2773, where the system checks to determine if a Translator 
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was provided (registered) for the Data Source object. If a Translator was provided, 
then at the decision box 2775 the system checks to determine if reflection has been 
requested. Those skilled in the art will understand that reflection is an operation that 
is provided by most OOP environments, such as by Java. 
5 If reflection is to be performed, then processing returns to Figure 27A via the 

off-page connector C, whereupon the Data Source is scanned. If reflection is not to 
be performed, or if no Translator was registered (a negative outcome at block 2773), 
then processing moves to the decision block 2774. At block 2774, the system checks 
to determine if the data item has registered any extended Translators. If there are no 

10 extended Translators, then at block 271 8 the data item attributes are derived, added, or 
hidden, depending on the data context gleaned from the DSL The data item is then 
fully exposed to data consumer components for use (block 2790). If there are 
extended Translators, an affirmative outcome at block 2774, then processing returns 
to Figure 27A via the off-page connector B to obtain the information from such 

15 Translators (block 2760). 

Figure 28 is a diagram showing how InfoModels provide contextualization 
within the XIS framework. The initial "raw" object (e.g., Java object or data from 
RDBMS) provided by the data source is exposed through mediation by successive 
"wrapping layers" of other objects, which determine which fields are visible, and 

20 possibly performs conversions or consolidations. Each "View" within the XIS 

framework, which contains one or more "INFOBEAN" consumers, carries with it its 
own context. Feeding a data source component to a consumer component places it 
within that context. 

When a data element provided by a data source is introduced to an InfoModel, 
25 the InfoModel actually provides a new element derived from this one to consumers. 
This derived element provides the actual data source interface discussed above. The 
attributes, type metadata, and methods provided for the element are first determined 
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as described below under "data exposure facilities". Then the InfoModel inspects the 
results and decides whether to add or derive any new attributes, or to hide existing 
attributes. Once the data is added to an InfoModel (discussed below) , it may be asked 
for by other components for processing and visualization purposes. 
5 In another embodiment, the ViewHost, a data consumer component, provides 

facilities allowing interactive cut and paste and drag and drop of information elements 
between different consumer components. When a cut-and-paste or drag-sand-drop 
occurs, each information element is decontextualized and then recontextualized inside 
the new InfoModel into which it is placed. This means that some attributes 

10 previously available may be removed, whereas others, more appropriate to the 
functions of the recipient consumers), may be added. 

Referring back to Figure 28, this figure shows how multiple InfoModels work 
to share references to raw objects. This figure also illustrates how an INFOBEAN 
and/or a DSI adds objects to the InfoModel to obtain data items. The DSI 2815 

15 creates an instance of source raw data item (e.g., Java object) 2830. The original 

source objects are maintained by DSI and one or more InfoModels have references to 
these source objects. The raw data item 2830 is provided to or may be used by an 
INFOBEAN (data consumer) via the addRawDataItem() method. (Please refer to 
Table III above. The second line of code shows that the source object is added to the 

20 TablelnfoClass.) 

The INFOBEAN 2820 requests the data item for the raw object 2835 (which 
was the source object 2830) from its InfoModel or the BaselnfoModel. The 
BaselnfoModel as discussed above is responsible for creating and caching every data 
item (wrapping any object). Each InfoModel is considered to contain a subset of data 

25 items from the entire set of data. The InfoModel is a view of the BaselnfoModel, 
thus, there may be data items in the BaselnfoModel that are not present in the 
InfoModel used by the INFOBEAN. The circles 2828 shown in the InfoModel 2805 
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represent attributes, domains, relationships, etc. from the BaselnfoModel. For 
example, Figure 6 contains a list of information that an INFOBEAN may obtain about 
the Person object, in this case 2830, 2835, through the LeifDataltem API. In addition 
information from nested InfoModels axe inherited. An InfoModel 2805 also always 
5 adds new items to the BaselnfoModel, e.g., common attributes such as "selection" are 
delegated. These new items are also exposed to the INFOBEAN as shown by the 
number of circles in 2840. 

The BaselnfoModel 2810 returns the raw data object 2845 to the InfoModel. 
The InfoModel 2805 returns a data item 2840, which exposes the information, for 
10 . example, shown in Figures 4 and 5 to the INFOBEAN 2820. A data item 2845 (see 
Figure 4) is returned, which may have been created or may have already existed in the 
InfoModel. 

In the XIS framework, as shown in the InfoModel, attribute and method 
"requests" mechanisms are available. Standard mechanism to retrieve the current 

15 value of any Attribute, or set the current value, if the Attribute is mutable, may also be 
. easily implemented. In one embodiment, this mechanism also enables a standard 
syntax and mechanism for the invocation of any domain method. 

These attribute and method "request" objects contain all of the information 
necessary for the data source to fulfill the requested task. It contains the actual 

20 ("raw") data item whose attribute value is being sought or set (along with the desired 
new value), or whose domain method is being invoked. They also contain contextual 
information, such as the current User, allowing data source developers to implement 
full user-based information access and security controls, and a context for obtaining 
services (implemented through the Java "BeanContext" APIs). This is significant 

25 because it enables the process of executing methods and/or getting or setting values to 
leverage services "in context" such as the current data view (or window) through 
which to interact with the user. These request objects also contain contextual "data 
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item" (e.g., LeifDataltem), as opposed to the "raw" non-contextual data item, from 
which to get additional or overridden values or execute additional/overridden 
methods, if appropriate to the task. In another embodiment, these "Request" objects 
are not only passed when getting/setting values, or executing domain methods, but are 
5 also passed to all other "Translator" methods that take and may need to access or 
manipulate the data item. The "Request" object not only provides context, but also 
ensures that the DSI (via the Translator) always has what it needs (particularly, the 
User information) to manage its security constraints, if any. 

A data item locking mechanism for obtaining, holding, and releasing a lock on 

10 an individual data item may be implemented in accordance with the present invention. 
This implementation is best defined by the data source provider, by implementing 
such locking mechanism in the data source, itself. Ad hoc implementations for data 
sources that do not provide native locking may also be done via the DSIs. This 
mechanism enables DSIs to implement multiple changes atomically (as one 

15 transaction) by effecting those changes at the time of the release. In addition, a 
"rollback" feature for atomic changes is possible through the "revert" capability, 
which generally releases the lock without affecting the previous changes. This 
locking mechanism may also be leveraged to lock multiple objects simultaneously, at 
the discretion of the DSI, by associating the lock with a DSI-defined "lock object" 

20 which can either be associated with a single data item or with a group of data items, as 
appropriate. Using the DSI API, this provides to data consumers a single API for 
dealing with locking implementations. 

Figure 29 shows an embodiment of a "plug-in manager" called PluglnManager 
of the present invention. The programming framework embodied in this invention 

25 includes a "plug-in manager" which provides extensible communication between 
services and components within an application. Plug-ins are software modules that 
add a specific feature or service to a larger system (i.e., plug into a larger application 
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to provide functionality). For example, there are a number of plug-ins for the 
NETSCAPE NAVIGATOR browser that enables the browser to display different 
types of audio or video messages, e.g., SHOCKWAVE by MACROMEDIA. 

A "service" is capable of obtaining information on a data consumer or data 
5 source component and capable of using that information to provide specific facilities 
to the application as a whole. Examples of such facilities include addition of entries 
to a top level application menu, loading MIME types into the global MIME type map, 
and running of scripts upon loading or unloading of data sources or consumers. The 
plug in manager loads new services at initialization and also at any time through an 
10 explicit request. The service in turn queries all modules present in the application as 
to whether they request any actions of the given service, executing them if so 
indicated. 

In more detail, as each new module, object, or component is loaded into the 
XIS framework, the PluglnManager 2905 on startup loads a special service called 

15 PluggableServiceFinder 2925, which searches for other services 2915 and loads the 
services found into the PluglnManager 2920. The PluglnManager holds or keeps 
track of all services. These services are referred to as PluggableServices. As each 
pluggable service is loaded, the PluglnManager searches such service for defined 
resources and attaches these resources to the appropriate components or performs 

20 actions on resources found 2935. For example, a menu manager service might search 
for resources specifying menu entries and associated operations. A component that 
wants to add a menu entry to the global application menu bar would simply provide a 
resource of this type. In essence, as each new module is loaded, the PluglnManager 
tells the currently registered services ("PluggableServices") to look for new plug-ins. 

25 Thus, in essence the PluglnManager acts as a plug-in for plug-in handlers. 

The combination of the PluglnManager and the PluggableService interface 
allows communication between an XIS application and various XIS components. The 
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components may contain a number of resources that affect certain areas of XIS. For 
example, they may have a resource file that contains an ECMA script. ECMA is an 
international industry association dedicated to the standardization of information and 
communication systems (see www.ecma.ch). If there is a PluggableService that 

5 knows about that resource file, then it may decide to run the ECMA script when it 
finds the resource. The PluglnManager is responsible for managing the resource list 
and all PluggableServices. When a new PluggableService is added, it is given all the 
resources to determine if it is interested in any of the resources on the list. If it is 
interested in a resource, then it may perform some action. 

10 In one embodiment of the invention, an ASCII file is created to indicate that a 

JAR file contains a resource to be provided to all PluggableServices. 

Table IX below shows an exemplary ASCII file that indicates that there are 
resources associated with the module containing the TableView class. It does not 
indicate what resources exist; it is up to the PluggableServices to determine if there is 

15 a resource in which they are interested. The PluglnManager, using Class. forNameQ, 
creates the Table Viewxlass and calls the loadPlugln method on each of the 
PluggableServices. Below is the content of the loadPlugln method in the 
MimeTypesPluggableService: 



Table IX 

public static final String RESOURCENAME = "leifResources/mime. types "; 
public void loadPlugIn(Class relativeClass) { 
if (loadedResources == null) { 
synchronized (this) { 

if (loadedResources — null) { 

loadedResources = new HashSetQ; 
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} 

} 

} 

try { 

String resource = PlixgInManager.convertResourceName( 

relativeClass, RESOURCE_NAME); 
ClassLoader loader = relativeClass.getClassLoaderQ; 
Enumeration enum = loader. getResources(resource); 
while (enum.hasMoreElementsQ) { 

URL resourceURL = (URL)enum.nextElement(); 

if (resourceURL !== null) { 

if (!loadedResources.contains(resourceURL)) { 
loadedResources.add(resourceURL); 

LeifJAEUtilities . addMimeTypes( 

baselnfoModel.getOwnedBeanContextChildQ, resourceURL); 
} 

} 

} 

} catch (IOException e) { 
e.printStackTraceQ; 

} 



The entire arrangement of data sources separated from consumers by a 
mediating structure, InfoModels providing context to Views, and a ViewHost and 
5 plug in manager playing set central organizing roles, allows a multi-purpose 
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application to be rapidly assembled out of preexisting components. Each available 
data source and consumer component may be integrated into the application by the 
plug in manager, and compartmentalization. 

Figure 30 shows a flow diagram of an embodiment of the invention that assists 
5 in creating XML (extensible markup language) DSIs and database DSIs. The XIS 
framework provides two sets of facilities for exposing electronically available 
] information that comes from data sources that are partly structured and/or self- 
describing, and for writing back possibly modified information to the sources. For 
example, one of these works for XML formatted data, and the other works for data 

10 stored in relational databases. However, the mechanisms are inherently extensible to 
any other data source that is partly structured and/or self-describing. 

The World Wide Web Consortium (W3C), which has standardized most of the 
XML formats to date, is in the process of defining a new XML format for declaring 
schemas, called XML Schema. The XML schema addresses the means for defining 

15 the structure, content, and semantics of XML documents. The present invention is 
configured to take into account future versions of the XML schema. 

In one embodiment, the present invention includes aspects of the method 
outlined below that are in common between the XML and relational database 
interfaces and can be applied in this general capacity to be part of the invention as 

20 well. In particular (described further below), an embodiment includes the apparatus 
involving separate processing of "data" (3002 branch) and "schema" (3004 branch) 
information, with a type conversion stage 3012 during the former and a metadata 
creation stage 3014 during the latter, followed by the construction of semantically 
enriched attributes 3016, 3018 based on the results of both these processes. 

25 In one embodiment, one method involves two apparatus or facilities designed 

to handle extensible markup language (XML) formatted data. An XML text stream 
comprises of a set of hierarchically structured "tags' 1 interspersed with text "content". 
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The names, data types, and ordering of the tags may vary from stream to stream and is 
specified by a separate document called an "XML schema." A description of the 
XML schema is provided in the document "XML Schema Part 1: Structures (Working 
Draft)", which may be obtained from the W3C at the WWW address of 
http://www.w3.org/TR/xmlschema-l, and also in the document "XML Schema Part 2: 
Datatypes (Working Draft)", which may be obtained at the WWW address of 
http://AVww.w3.org/TR/xmlschema-2. Given an XML data stream, the first apparatus 
parses the XML schema appropriate for it and constructs metadata specifications 
appropriate for the contents of each tag. In some cases, these specifications are in the 
form of computer program segments that can be compiled into executable procedures 
that can be accessed immediately by a running application; in other cases, they refer 
directly to already precompiled procedures. The second apparatus parses the data 
document, matching the tags up with the types and metadata derived from the schema, 
and exposes the content in the standardized information representation using this 
metadata. This information includes the generic relational links described above in 
addition to attributes and metadata. 

In particular, the structures defined by an XML schema document determine 
the hierarchical and type structure allowed in XML instance documents, and this 
structure is paralleled again in the information elements (with attributes and member 
elements) constructed on parsing an instance. The following table (Table X) shows 
the correspondence: 
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Table X 


XML Schema 


Compliant XML 
Instance 


Resulting Information 
Element 


simple type outside attribute 
declaration 


element with no 
subelements 


(typed) attribute 


simple type inside attribute 
declaration 


attribute 


(typed) attribute 


complex type without 
descendents 


element with attributes 
but no subelements 


information element with 
attributes 


complex type with 
descendents 


element with 
subelements 


information element with 
member elements 



A complexType element, as defined in the W3C XML Schema standard, 
defines the structure of an information element. Elements contained within the 

5 complexType element which are defined as complexTypes themselves, are translated 
into the member elements of the information element defined by the containing 
complexType. All other elements and attributes contained within the complexType 
element, and defining single value types, are translated into attributes of the 
information element defined by the containing complexType. 

10 The XML ingestion process supports an additional capability that allows for 

the translation of types defined by an XML Schema, into more semantically rich 
domain policy based attributes that consumers in the present framework can take 
advantage of. To do this an embodiment of the present invention includes a process 
that uses XSLT (XML Stylesheet Language Transformations) to scan an XSDL 

15 (XML Schema Definition Language) document, and embed domain specific 

instructions in a new version of the XSDL document. The embedded instructions 
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direct the XML processing software to create information elements that contain the 
semantically richer domain attribute representations. In particular, the tags in the 
table below may be placed by the XSLT within <appinfo> subelements of elements in 
the XSDL schema document. When the schema parsing apparatus reads the resulting 

5 schema, it sets up the XML processor to perform the mappings as shown when 
reading an instance document. Because of the nature of the handling specified for 
<appinfo> elements in the XSDL specification (see the W3C Web site at 
http://www.w3.org/XML/Schema), these will simply be ignored by other XML 
schema processors that have not been designed to read them. Table XI lists properties 

10 that may be used: 



Table XI 


Property 


Description 


domainfield 


A Domain Policy attribute to map instances of this XML element 
or attribute to 


typemetadata 


A metadata type to map instances of this XML element or 
attribute 


converter 


A type converter for transformation of XML data values (strings) 
into typed values such as floating point numbers or date objects 


visible 


The initial visibility state with which instances of this XML 
element or attribute should be exposed within an information 
element 


mutable 


Whether or not instances of this XML element or attribute can be 
edited after being exposed within an information element 
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Conversely, the system has the ability to construct an XML document and 
associated XML Schema from a hierarchy of information elements. The process for 
outputting an XML document and associated XML Schema from a hierarchy of 
information elements is essentially the reverse of the ingestion process. The resulting 
5 schema documents are generated with the special <appinfo> instructions that carry the 
additional semantic meaning for the attributes, but (see above) these additional 
instructions are embedded in a way that makes them transparent to other XML 
document readers that do not recognize them. In this way, an application-to- 
application information communication session can be set up using HTTP or a similar 

10 protocol for synchronous communications, and SMTP or similar for asynchronous 
communications. The sending application encodes information elements into an 
XML schema/instance pair using the just described apparatus and sends both to the 
receiver application. The receiver reconstructs the information elements also using 
the above apparatus. Thus, any form of structured, annotated information that can be 

15 expressed within our framework can be transmitted between applications using a 
simple document transfer protocol. Another embodiment of the present invention 
involves an apparatus 3020 , which will connect to a relational database system and 
extract or write information from it using the structured query language (SQL). The 
user of such an information source needs only to specify the tables and columns to 

20 access within the database, as well as any selection criteria to narrow the range of data 
returned. The apparatus performing this function will automatically convert the data 
in the database into the appropriate representational format and add metadata and 
parent-child links as required. In general, the process is similar to that described for 
the XML data input/output capability, except that SQL statements and conversion 

25 mappings specified by the user take the place of the XML schema and document type 
and hierarchy information. 
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The process translates the result of a database query into an XIS data item, and 
each row in the result set is translated into a member data item of the result data item. 
Each row data item can also have a database query associated with it which can be 
executed to provide its own member data item. Access to the member items is on- 
5 demand (e.g., as called for by a consumer), an operation we refer to as "drill-down". 
The row data items are created with attributes that are derived from the 
columns returned by the result set. The attribute specifications can be generated 
automatically from the result set column SQL type specifications (integer, date, text, 
etc.), or can be customized to suit the needs of the user. The customization process 

10 allows the user to map database result column type definitions into more semantically 
rich domain policy and/or metadata-enhanced attributes that consumers can take 
advantage of. In other words, the DSI can associate column data types with metadata 
types and domain policy attribute types. To do this the framework supports a number 
of attribute customization properties that the user can specify (described further 

15 below). 

Modifications to row data items are handled by allowing the user to associate 
parameterized update, insert and delete queries with a given result set. When the 
value of a record member attribute is changed, the user specified parameterized query 
is executed, and the parameters are filled in from the attribute values identified in the 
20 query specification. Insertion and deletion of record members are handled in a 
likewise manner. 

The following table, Table XII, describes the list of customizable properties 
supported by the SQL database interface process. These properties are used to 
describe a single interface to a database for producing one or more hierarchically 
25 organized information elements from its contents. 
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Table XII 


Property 


Description 


jdbc. driver 


JDBC vendor driver class name 


jdbc.url 


JDBC database connection URL 


display .name 


Default display name for result data item 


select, query 


SQL select statement for result data item 


update .query 


Parameterized SQL update statement 


update.columns 


Result column names that fill update query parameters 


insert.query 


Parameterized SQL insert statement 


insert.columns 


Result column names that fill insert query parameters 


delete, query 


Parameterized SQL delete statement 


delete, columns 


Result column names that fill delete query parameters 


drilldown. query 


Parameterized SQL select statement for record drill- 
down 


drilldown . columns 


Result column names that fill drill-down query 
parameters 


result.attributes 


Result data item attribute names 


record.attributes 


Record data item attribute names 



The names of attributes listed for both result and record data items are used to 
uniquely identify the attributes. The customization of each attribute is done according 
5 to its unique name. The following table (Table XIII) describes the list of 

customizable properties that can be applied to each attribute, where <name> is the 
unique attribute name. Note the parallel between these properties and those given for 
the f <appinfo> ? tag insertion in the case above of XML data parsing. 
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Table XIII 


Property 


Description 

Mr 


<natne> .label 


The attribute display label 


<name>. domainfield 


A XIS Domain Policy class field to map this attribute 
to 


<name>.typemetadata 


A XIS metadata class name to map this attribute to 


<name>.converter 


A XIS type converter for transformation of result 
values 


<name>.columns 


The result columns names that will be converted 


<name> .visible 


The attribute initial visibility state 


<name> .mutable 


The editability of the attribute 



Given the metadata from known industry standard APIs (e.g., JDBC and 
ODBC) that provide metadata for results (typically handled as tabular columns) 
5 including string, length, numeric precision, date formatting, etc, relational databases 
may have dynamic DSI toolkit built and implemented as shown in Figure 27. Tabular 
data may also be interpreted as a default string typed. Java objects, remote Java 
objects (via RMI or CORBA-derived interfaces), and Enterprise JavaBeans (a variant 
of RMI objects) may have DSIs automatically created for them, using, for example, 
10 reflection and known types (primitives and other typical types like String, Data, etc., 
and registered types). A developer may also place XlS-specific annotations (e.g., 
static AttributeDescriptor and FieldData methods) on reflected Java objects. 
Collection subclassed objects may also indicate containment. 

Dynamic data supplemental metadata may also be used in the XIS framework 
15 of the present invention. Schemas with little or no expressive information may also 
be used to specify additional metadata within the XIS framework, which include 
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mapping attributes to type metadata, mapping attributes or methods to domains, 
defining new attributes/methods based on existing data from the source, defining 
functions/user commands for easily implemented capabilities (e.g., deleting a data 
item, adding/inserting a new data item, initializing a template data item that a user can 
5 fill in before adding, etc.), and defining relationships to other data items to perform 
"drill-down" queries. Such type of schemas may be obtained, for example for Java 
Metadata API, CORBA API (on which the Java API was based), Oracle "common 
warehouse metamodel," and the like. Other formats for mapping metadata to schemas 
from other sources, or as might be defined in the future, may easily be incorporated 
10 within the framework. 

Distributed Application Capabilities 

In an embodiment, the application development framework being discussed 
offers three sets of facilities to aid in the development of distributed applications in 
which users, software application components, or both are distributed across multiple 
15 computers connected by a network. 

CORBA Exposure 

The first set of facilities allows the automatic exposure of a data source over a 
network to any remote consumer software object via the Common Object Request 
Broker Architecture (CORBA) protocol. This protocol allows the remote consumer to 
20 utilize information elements just as if they existed locally, but usually with lower 

bandwidth than it would take to send the entire elements over the network connection. 

To better understand the invention, examples are shown below in Table XIV, 
which shows an exemplary XML document. 



Table XIV . 


<tracks> 




<track name="FIRST"> 
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<country>US</country> 
<category>SUB</category> 
<threat>HOS</threat> 
<position> 

<lat>10.0</lat> 
<lon>10.0</lon> 
<alt>10.0</alt> 
</position> 
</track> 

<track name="SECOND"> 
<country>US</country> 
<category>AIR</category> 
<threat>FRI</threat> 
<position> 

<lat>20.0</lat> 
<lon>20.0</lon> 
<alt>20.0</alt> 
</position> 
</track> 
</tracks> 



The following table (Table XV) shows the result if the above XML document 
were run through an XML DSL 

5 

Table XV 

LEIF Data Item - tracks ~~~~ ~~ ~~ ~ 
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LEIF Data Item - track 

Attribute - name : String value='FIRST' 
Attribute - country : String value='US' 
Attribute - category : String value='SUB' 
Attribute - threat : String value='HOS' 
LEIF Data Item - position : LEIF Data Item 
Attribute - lat : String value='10.0' 
Attribute - Ion : String value='10.0' 
Attribute - alt : String value='10.0' 
LEIF Data Item - track 

Attribute - name : String value=' SECOND' 
Attribute - country : String value='US' 
Attribute - category : String value='AIR' 
Attribute - threat : String value='FRI' 
LEIF Data Item — position 

Attribute - lat : String value='20.0' 
Attribute - Ion : String value='20.0' 
Attribute - alt : String value='20.0' 



Table XVI below shows an exemplary XSDL document. 



Table XVI 

<?xml version="1.0" encoding="UTF-8"?> 
<schema xmlns="http://www.w3 .org/1 999/XMLSchema"> 
<element name- 'tracks"> 
<complexType> 

<element name— 'track" type- Track" maxOccurs— 'unbounded7> 
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</complexType> 
</element> 

<complexType name— Track M > 

<attribute name= M name" type="string"/> 
<element name="country" type="string7> 
<element name="category" type="string'V> 
<element name— "threat" type="stxing"/> 
<element name="position" type- f LatLonAlt7> 

</complexType> 

<complexType name= ,, LatLonAlt"> 

<element name- f lat" type- 'decimal 7> 
<element name= tf lon" type= " decimal 1 V> 
<element name="alt" type="decimal7> 

</ complexType> 
</schema> 



XML Schema Definition Language (.xsd) documents are used to express the 
semantic descriptions of Attributes and the Domains in which they live. Code 
5 generation utilities as described above create the actual Domain Objects with their 
groups of related Attributes. Thus, developers may create new Domains, and add 
Attributes to their existing Domains, by modifying these XML Schema files and 
generating the appropriate Java code. XML Schema files include basic attribute 
constraints (e.g., value ranges, list of valid values, attribute naming, formatting, etc.) 
10 that are turned into TypeMetaData objects, as well as textual comments that are 

converted into Java documentation to define the intent of the attribute (or method, in 



90 



WO 02/46916 



PCT/USO 1/48418 



the case of Domain methods). In some cases, Java code is embedded in the document 
and used inline in the generated Java classes for the Domain. 

Table XVII below shows the result when the above XSDL document is used to 
type the elements in the XML document source. Note that the type for lat, Ion, and alt 
5 are now Double instead of String. 



Table XVII 

LEIF Data Item - tracks 
LEIF Data Item - track 

Attribute - name : String value='FIRST' 
Attribute — country : String value='US' 
Attribute — category : String value='SUB' 
Attribute - threat : String value='HOS' 
LEIF Data Item - position 

Attribute - lat : Double value='10.0' 
Attribute - Ion : Double value-' 10.0' 
Attribute - alt : Double value='10.0' 
LEIF Data Item - track 

Attribute - name : String value=' SECOND' 
Attribute — country : String value='US' 
Attribute - category : String value=' AIR' 
Attribute - threat : String value='FRI' 
LEIF Data Item - position 

Attribute - lat : Double value='20.0' 
Attribute - Ion : Double value='20.0' 
Attribute - alt : Double value='20.0' 
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The following table (Table XVIII) shows an exemplary XSLT document. 



Table XVIII 

<xsl:for-each select="xsd:element"> 
<xsl:choose> 

<xsl : when test=" ©name-position* "> 
<xsl:copy> 

<xsl:apply-templates select="@* ! 7> 
<annotation> 
<appinfo> 

<domainmap 

domainfield= n com.xis. domains. geo.GeoDomain.latLonAlt" 
converter="DegreesToLatLonAltConverter" 
parameters- 'latjlon^alt" 
label="Position" 

/> 

</appinfo> 
</annotation> 
</xsl:copy> 
</xsl:when> 
<xsl : otherwise> 
<xsl:copy> 

<xsl:apply-templates select="@*"/> 
</xsl:copy> 
</xsl:otherwise> 
</xsl:choose> 
</xsl:for-each> 
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When such a transformation is used with the previous XSDL source shown 
above, used to type the XML document source, the result is shown in Table XIX 
below. 



Table XIX 

LEIF Data Item - tracks 
LEIF Data Item - track 

Attribute - name : String value='FIRST' 
Attribute - country : String value='US 5 
Attribute - category : String value='SUB' 
Attribute - threat : String value='HOS' 
Attribute - position : LatLonAlt <- now mapped to 

GeoDomain.latLonAlt 
LEIF Data Item - track 

Attribute - name : attribute value=' SECOND 5 
Attribute - country : String value='US' 
Attribute - category : String value='AIR ? 
Attribute - threat : String value='FRT 
Attribute - position : LatLonAlt <- now mapped to 

GeoDomain.latLonAlt 



Note that position has been mapped to GeoDomain.latLonAlt, meaning, it is 
now a LatLonAlt type. The lat, Ion, and alt attributes are still the same, but the 
position itself may now be dealt as a single LatLonAlt object rather than a generic 
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data item with three Double fields. The use of XSLT also enables the mapping of 
XML elements into TypeMetaData, such as the LatLonAltTypeMetaData in order 
have better manipulation of the data. 

In one embodiment of the invention, the XIS framework has a "remote" 
capability enabling referral to an XIS session, or the data within it, from a remote 
virtual machine. Primarily, this means that data retrieval and sharing is the basis for 
export and collaboration. Secondarily, it supports operating on data within XIS from 
a remote virtual machine, perhaps on information existing only at that remote virtual 
machine. 

In another embodiment, SOAP (Simple Object Access Protocol) may be 
utilized. SOAP is a messaging framework that defines a protocol for the exchange of 
information in a decentralized, distributed environment. See, for example, the W3C 
Web site at http://www.w3.org/TR/SOAP. SOAP provides an instantiation of the 
remote capability, and is used to enable a general-purpose means of mating together 
or communicating among distributed sessions. These sessions may be two full XIS 
sessions on separate servers, or may comprise one XIS server and one XIS client, or 
may be used to interface XIS to otherwise very different software, even including 
software applications written in different programming languages and running on 
incompatible operating systems. All data and remote procedure calls are made 
through XML. Those skilled in the art will be understand that SOAP is an XML- 
based protocol. The working draft of this specification is currently being developed 
bytheWSC. 

In another embodiment, remote references are used. These references are 
persistable or persistent references to XIS data. In a distributed context XIS uses 
XML representations of the references to share, persist, or identify particular data. 
Embedded in the XML are custom information enabling determination of data 
location in files or databases, on web servers, or based on unique Ids or names within 
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the XIS session, or based on data which are passed to a constructor, or on an ECMA 
script that can re-generate the data object. 

In another embodiment, the data representation in the remote distributed 
sessions is all based on the XIS mediation layer. All data, regardless of the initial 
5 type, is passed and manipulated as sets of attributes and relationships. This greatly 
enhances portability and interoperability of the data. At the same time the data 
contains a global unique identifier, so the individual and specific source and identity 
of that data is maintained in spite of having been translated to a mediated format. 

In another embodiment, a metadata type, e.g., "Constructor Scripts," is used. 

10 This metadata type supports the generation of ECMA Script scripts to restore a 
TypeMetaData (metadata type) object at a later time. By executing the script, the 
TypeMetaData is restored to its exact state. The advantage over standard Java object 
serialization is control over the save/restore process, and the ability to represent the 
state in fairly readable text format. 

15 Distributed Multi-user Collaboration 

Figure 31 is a schematic diagram of the second set of facilities that allows 
users at remote computers to collaborate through shared views of the same data. It 
also shows objects and methods that may be involved in distributed collaboration 
facilities. Visual consumer components (e.g., INFOBEANs) are condensed and 

20 compressed so that they may be efficiently accessed by a remote computer and then 
locally displayed. This is done using a MetaView object, which encapsulates the 
essential elements of a visual component to allow reconstruction on another screen 
with minimum requirement for data transmission. MetaViews are manipulated using 
the relationship handling machinery of the framework as discussed above; in 

25 particular, an indirect reference to the MetaView is produced and passed around to 
remote consumers, who need only resolve the reference and retrieve the MetaView 
object if the user requests the display. 
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An event-handling schema is introduced for transmission of changes in the 
view from one computer to all others that are joined to the session. View 
management is accomplished via a "tree" display showing hierarchies of local views, 
sessions, and shared views (including properties and subsidiary data items). Views 
5 may be shared through the intuitive action of dragging and dropping them from one 
branch on the tree to another. Multicast protocols may be used so that MetaViews, 
LeifReferences (references), and Event objects may be transmitted directly from one 
computer to another without the need to go through a server. Alternatively, HTTP 
protocols may be employed if security and firewall considerations make multicasting 
10 impractical. 

Metadata Server Facilities 

Figure 32 shows a third set of facilities that allows remote consumer software 
objects 3220 to obtain additional annotations on information that is encountered along 
with at least a minimal self-description component, as may be found, e.g., in an XML 

15 tag name. These facilities are targeted to be useful to software agents 3202 in 

particular. (See Wooldridge, M., Jennings, N. (1995); "Intelligent Agents: Theory 
and Practice" in Knowledge Engineering Review 10:2.) For example, a Java software 
agent may occasionally encounter data objects or request terms, which were not 
anticipated when the agent was programmed. The tag name or other descriptive 

20 annotation (connector) 3206 is used as a key to request metadata and possibly domain 
policy methods defined within XIS from a known server, called a semantic repository 
3204. The server 3204 checks its index for a match; if a match is not found, it can 
optionally ask a predicate logic inference engine 3208 to provide alternate names to 
search under (e.g., "cat, large, ferocious" is returned from the inference engine in 

25 response to a request for "lion"), which are then also compared to the index. If a 
match is found, the server returns the appropriate metadata and possibly domain 
policy method(s) to the requesting agent 3202, making use of either Sun f s Jini 
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framework or Java's built-in provisions 3222 for network transfer and subsequent 
dynamic loading of classes (including, e.g., procedural components of the metadata 
and methods) to transfer the actual code procedures into the running agent. These 
transferred information can then be used by the agent 3202 to aid in handling the 
object. For example, an agent can display an unanticipated data type to a user by 
calling the renderer method thus returned from the semantic repository. The semantic 
repository may also interface with other repositories 3212 via a data network 3210, 
such as a wide area network (WAN) 3210. 

In the above embodiment, information metadata and even information access 
software may be dynamically downloaded from remote sources ("semantic 
repositories" or "Metadata Server Facilities"), e.g., from the data source itself or from 
an intermediary server. This is a unique feature particularly as applied to XIS 
metadata, domain policies, and DSIs. 

One skilled in the art will further understand that the common representation of 
and access to information from internal APIs (mediation layer) may be exported to 
distributed application in support of middleware architectures for scalability or other 
advantages, and in support of collaboration by sharing data and data changes 
(permanent or transient) with other distributed collaborators. 

The present invention also supports user "transfer" of objects from one context 
(e.g., between two INFOBEANs) via drag/drop, cut/paste, and other mechanisms. 
Transfers of objects apply only to non-contextual information. Thus, each view has 
its own InfoModel that provides the contextual information for that view alone. 
Example 5 below further explains this idea. 

Example 5 

The Example 5 application is contained in three Java source files, 
HelloWorld Java, HelloWorldTranslator.java, and TestHarness.java. The source files 
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for this Example are explained below. The resulting outputs are shown in Figures 
38A and 38B. Non-contextual information is transferred in this Example. 

The Java source files in Example 5 modify those from Example 3 or 4 to 
demonstrate the use of drag and drop facilities within XIS, along with a more 
complex view. As before, changes from the previous step are marked by open and 
close commented braces. 

The table below (Table XX) shows a code snippet that replaces a portion of 
code in the Hello World.java file shown in Example 3. The code portion below 
replaces the portion of code 2102 found in Figure 21 to implement Example 5. 



Table XX 

/*{*/ 

private String myName; 
public HelloWorld(String myName) { 
this. myName = myName; 

} 

public String toStringQ { 
return myName; 

} 

/*}*/ 



With the above modification, the Hello World.java file for this Example has 
been enhanced so that instances can be given names upon creation, and this name is 
15 returned by the toStringQ method. Also, the getID() method has been removed. 
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The HelloWorldTranslator.java file for this Example is similar to the 
HelloWorldTranslator.java file shown in Figures 22A to 22C, except that this source 
file has been simplified from the previous version by removing the "course" attribute. 

Figures 37A to 37D list the TestHarness.java source file, where the bulk of the 
5 changes are coded. First of all, it contains an import to help lay out multiple 

components within a Jframe 3702, and also imports for two new XIS INFOBEANs: a 
Table bean and a Tree bean 3704. The tree bean displays data items and any member 
data items they contain, and enables users to select and perform various functions on 
them such as editing their properties. The table bean displays the attributes of 
10 multiple data items in a user-configurable way. 

The first portion of new code 3 706 A and 3706B initializes several HelloWorld 
objects and inserts them into an array. The table and plot INFOBEANs are initialized 
and placed side-by-side in a JFrame. They are not loaded with any data items, but 
items can be dragged onto them when the application is running. The next thing is 
15 that a tree INFOBEAN is initialized and loaded with the array, and it is put up in its 
own JFrame. 

This Example 5 application puts up two windows— the first is a Tree 
INFOBEAN containing several HelloWorld data items. The second has two frames, 
on the left a Table INFOBEAN, on the right a Chart INFOBEAN, both of which are 

20 initially empty. The table is initially completely blank because it has no information 
on what headings are appropriate, while the plot displays a default grid. 

In the tree display, a user may select data items or open and close them, similar 
to the directory tree view provided by the "Windows Explorer" application. In this 
case, the only item that contains anything is the root, which is a special data item, 

25 Double-clicking on it opens or closes it, but it cannot itself be selected. Right clicking 
on an item (but not the root) brings up a menu of operations that may be performed on 
it. In particular, selecting 'Properties 1 brings up a property sheet window (as in the 
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previous examples) for that particular instance. A user may left-click-and-drag on 
data items from the property sheet window over to the table or the plot. 

The table automatically sets up columns for the preferred attributes of the data 
items dragged onto it. The layout may be changed interactively by either dragging on 

5 the headings or their boundaries, or by right clicking on the headings. Double 

clicking on the attributes enables a user to edit them. Items may also be dragged from 
the table onto the plot as well, or in the other direction. The selection and pen color 
attributes are kept aligned automatically between all views of the same data item. A 
user exits the application by closing the tree window. 

10 Data item commands, also known as JAF Commands (based on "JavaBeans 

Activation Framework") may also be implemented within XIS. The JAF API is a part 
of Java and provides a way to associate commands with object. By using JAF, 
developers may take advantage of standard Java interfaces to determine the type of an 
artitrary piece of data, encapsulate access to it, discover the operations available for it, 

15 and to instantiate the appropriate bean to perform said operation(s). For example, if a 
browser obtained a JPEG image, JAF would enable the browser to identify that the 
stream of data is a JPEG image, and from that type, the browser could locate and 
instantiate an object that could manipulate, or view that image. JAF commands are 
typically used in pop-up menus or menu bars to control objects. 

20 XIS uses JAF commands to control DSIs and perform operation on data items. 

Right clicking on a data item in an InfoBean pops up a menu with commands that are 
specific to that data item. JAF commands with XIS may implement the following: 

- "Context Menus" or pop-up menus initiated by right clicking on a 
25 display that represents one (or more) data items; 



100 



WO 02/46916 



PCT/US01/48418 



- Command "menus" may be combined into a menu for multiple objects 

(e.g., one single command (menu item) to delete all selected 
objects; 

- Addition of data item commands per object type by adding them to the 

"JAF" registry; 

- Addition of file/content MIME types in the display; 

- Addition to the "JAF" registry of entries that represent objects that can 

add any number of menu items dynamically; 

- JAF commands may be added by "Menu Populators" that can add 

menu items for single and multiple data items; 

- JAF commands may be added by the environment for other typical 

functions that might be performed on any object (possibly 
depending on capabilities/content of that data item), e.g., 
Copy/Paste/Cut/Delete, Hide/Show, Refers To (if the object 
exposed relationships to other objects which may or may not be 
loaded yet), Contains, Referred by, Contained by, URLs 
(attributes), Properties, etc.; and 

- Default behavior of "Properties" command may be overridden using a 

"JAF entry." 

Figures 38A 5 38B, 38C, and 38D show how JAF is used within the framework. 
Figure 38A shows a menu of HelloWorld objects for selection, displayed on a screen 
of the computer system implementing the framework. Figure 38B shows that the 
HelloWorld objects are displayed through a graphing (data plot) viewer. Figure 38C 
shows the display of Figure 38B after the display cursor has been positioned over the 
bar graph, followed by a right-click. A context menu, enabling the user to select the 
"Properties" option, is displayed in Figure 38D. In this example, the HelloWorld 
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object can be manipulated by a PropertySheetlnfoBean object. Thus, selecting the 
"Properties" option results in a PropertySheetlnfoBean being instantiated showing the 
properties of the First HelloWorld object, as shown in Figure 38D. 

Another feature provided by the XIS framework is the use of attribute aliases. 

5 This enables one attribute from one domain to be substituted for an attribute in 

another domain. For illustration purposes, let us assume that we have two domains 
called Movement Domain and Physics Domain. The attribute speed in knots is 
defined in the Movement Domain, while the attribute velocity in meters/sec is defined 
in the Physics Domain. The XIS framework enables a developer to register or define 

10 that the speed attribute in the Movement Domain is similar or compatible with the 
velocity attribute in the Physics Domain. Thus, enabling a data consumer object to 
ask for the Attribute from the domain that it knows about, and have the value 
translated from the Attribute of the DSI from the second domain. 

Figure 39 A, 39B, and 39C show details of an exemplary embodiment 

15 explaining how an interface for the attribute alias feature described above may be 
defined or implemented within the XIS framework. The illustration includes class 
listing for objects that are used in the preferred embodiment of the framework. 

Figure 40 is a block diagram of a computer that may be used to implement the 
framework described herein. The framework may be used in a single computer, or 

20 may be used in conjunction with one or more computers that may communicate with 
each other over a network to share data. Those skilled in the art will appreciate that 
the various data objects, framework extensions, and other processes described above 
may be implemented with one or more computers, all of which may have a similar 
computer construction to that illstrated in Figure 40, or may have alternative 

25 constructions consistent with the capabilities described herein. 

Figure 40 shows an exemplary computer 4000 such as might comprise a 
computer in which an object oriented programming environment is supported to 
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permit the framework operations described above, and to permit the various display 
operations and computer processing events. Each computer 4000 operates under 
control of a central processor unit (CPU) 4002, such as a "Pentium" microprocessor 
and associated integrated circuit chips, available from Intel Corporation of Santa 
5 Clara, California, USA. A computer user can input commands and data from a 
keyboard and computer mouse 4004, and can view inputs and computer output at a 
display 4006. The display is typically a video monitor or flat panel display. The 
computer 4000 also includes a direct access storage device (DASD) 4008, such as a 
hard disk drive. The memory 4010 typically comprises volatile semiconductor 

10 random access memory (RAM). Each computer preferably includes a program 

product reader 4012 that accepts a program product storage device 4014, from which 
the program product reader can read data (and to which it can optionally write data). 
The program product reader can comprise, for example, a disk drive, and the program 
product storage device can comprise removable storage media such as a magnetic 

15 floppy disk, a CD-R disc, a CD-RW disc, or DVD disc. 

The computer 4000 can communicate with other computers over a computer 
network 4016 (such as the Internet or an intranet) through a network interface 4018 
that enables communication over a connection 4020 between the network 4016 and 
the computer 4000. The network interface 4018 typically comprises, for example, a 

20 Network Interface Card (NIC) or a modem that permits communications over a 
variety of networks. 

The CPU 4002 operates under control of programming steps that are 
temporarily stored in the memory 4010 of the computer 4000. When the 
programming steps are executed, the computer performs its functions. Thus, the 

25 programming steps implement the functionality of the event tracking process 

described above. The programming steps can be received from the DASD 4008, 
through the program product storage device 4014, or through the network connection 
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4020. The program product storage drive 4012 can receive a program product 4014, 
read programming steps recorded thereon, and transfer the programming steps into the 
memory 4010 for execution by the CPU 4002. As noted above, the program product 
storage device can comprise any one of multiple removable media having recorded 
5 computer-readable instructions, including magnetic floppy disks and CD-ROM 

storage discs. Other suitable program product storage devices can include magnetic 
tape and semiconductor memory chips. In this way, the processing steps necessary 
for operation in accordance with the invention can be embodied on a program 
product. 

10 Alternatively, the program steps can be received into the operating memory 

4010 over the network 4016. In the network method, the computer receives data 
including program steps into the memory 4010 through the network interface 401 8 
after network communication has been established over the network connection 4020 
by well-known methods that will be understood by those skilled in the art without 

15 further explanation. The program steps are then executed by the CPU 4002 thereby 
comprising a computer process. 

It should be understood that the any device that supports the framework 
envirnonment described above, acting as a host computer, will typically have a 
construction similar to that shown in Figure 40, so that details described with respect 

20 to the Figure 40 computer 4000 will be understood to apply to all computers of any 
network system in which the framework or framework-developed applications are 
utilized. Alternatively, the devices can have an alternative construction, so long as the 
computer can communicate with the other computers and can support the 
functionality described herein. 

25 All patents, patent applications, publications and references mentioned in the 

specification are indicative of the practice level of those skilled in the art to which the 
invention pertains. All patents, patent applications, publications and references are 
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herein incorporated by reference to the same extent as if each individual patent, patent 
application, publication or reference was specifically and individually indicated to be 
incorporated by reference. 

One skilled in the art should readily appreciate that the present invention is 
5 well adapted to carry out the objects and obtain the ends and advantages mentioned, 
as well as those inherent therein. The specific embodiments described herein as 
presently representative of preferred embodiments are exemplary and are not intended 
as limitations on the scope of the invention. Changes therein and other uses will 
occur to those skilled in the art which are encompassed within the spirit of the 

10 invention are defined by the scope of the claims. It will be readily apparent to one 
skilled in the art that modifications may be made to the invention disclosed herein 
without departing from the scope and spirit of the invention. 

The present invention has been described above in terms of presently preferred 
embodiments so that an understanding of the present invention can be conveyed. 

15 There are, however, many configurations for information system frameworks not 
specifically described herein but with which the present invention is applicable. The 
present invention should therefore not be seen as limited to the particular 
embodiments described herein, but rather, it should be understood that the present 
invention has wide applicability with respect to information systems generally. All 

20 modifications, variations, or equivalent arrangements and implementations that are 
within the scope of the attached claims should therefore be considered within the 
scope of the invention. 
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CLAIMS 

We claim: 

5 

1 . An extensible framework for use in a computer system that supports an 
object oriented programming environment and includes a memory in which data 
objects can be stored, the framework comprising a set of object classes that can be 
extended using object oriented principles to define an information handling 

10 application with data objects comprising a class of data source objects and a class of 
data consumer objects, and a mediation layer that defines an interface between the 
data source objects and the data consumer objects to permit data communications 
between the two data object classes, such that the class configuration of the data 
source objects can be specified independently of the class configuration of the data 

1 5 consumer obj ects . 

2. A computer system that supports an object oriented programming 
environment and includes access to data storage containing specifications for a set of 
object classes that can be extended using object oriented principles to define an 

20 information handling application with data objects comprising a class of data source 
objects and a class of data consumer objects, and a mediation layer that defines an 
interface between the data source objects and the data consumer objects to permit data 
information exchange between the two data object classes, such that the class 
configuration of the data source objects can be specified independently of the class 

25 configuration of the data consumer objects. 
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' 3. A computer system as defined in claim 2, wherein the mediation layer 
defines a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

4. A computer system as defined in claim 3, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

5. A computer system as defined in claim 3, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 
data source class objects. 

6. A computer system as defined in claim 3, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

7. A computer system as defined in claim 3, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

8. A computer system as defined in claim 4, further including a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 
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9. A computer system as defined in claim 8, further including a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

10. A computer system as defined in claim 6, wherein an attribute alias may 
be specified by a user to indicate any data source attributes of an attribute domain that 
may be substituted with attributes of a different attribute domain. 

11. A computer system as defined in claim 4, wherein said 
attribute/metadata interface provides input/output functions for display and editing of 
the attribute during runtime. 

12. A computer system as defined in claim 4, further including a 
FieldMetaData attribute that specifies processing criteria for an attribute of a data 
object. 

13. A computer system as defined in claim 4, wherein the processing 
criteria relates to a selected attribute of the data object for display processing. 

14. A computer system as defined in claim 5, wherein the indicated 
relationship may be resolved using a version of the Relationship object in cache of the 
computer system. 

15. A computer system as defined in claim 2, further including a 
collaboration facility that permits a user at a network computer remote from the 
computer system to share a view of a data object at the remote network computer. 
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16. A computer system as defined in claim 15, wherein the collaboration 
facility comprises a MetaView class of data objects that lightweight encapsulate 
elements of a data object for visual reconstruction on a display screen of the remote 
network computer. 

5 

17. A computer system as defined in claim 4, wherein the data interface 
provides an override function that can override default metadata of the data object 
attributes. 

10 18. A computer system as defined in claim 6, wherein the data interface 

provides an override function that can override default metadata of the data object 
attributes. 

19. A computer system as defined in claim 3, wherein data objects provided 
15 through the data interface comprise information that specifies data attributes, 

relationships, event broadcasting of changes in all registered data consumer objects, 
metadata for attributes that provide declarative and procedural information and/or 
input/output functions for display and editing, and related data items, and wherein the 
data objects can store references without direct access to a related data item. 

20 

20. A computer system as defined in claim 19, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata. 

25 21. A computer system as defined in claim 3, wherein the mediation layer 

further includes object classes that include one or more methods that provide data 
exposure, and further including a Data Source Interface object class of data objects 
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with methods that automatically determine which data exposure method will be used 
for data communications between the data source objects and data consumer objects. 

22. A computer system as defined in claim 2 1 , wherein the determined data 
exposure method comprises data object reflection and introspection. 

23 . A computer system as defined in claim 2 1 , wherein the data exposure 
methods include a data source object method that provides a standard interface, a data 
source object and a Translator object that maps an alternate data interface to the 
standard interface, and a data source object that is inspected by the computer system 
to determine available data fields which are thereby exposed to data consumer objects 
by the standard interface. 

24. A computer system as defined in claim 3 5 wherein the data interface of 
the mediation layer provides a wrapper for the data objects. 

25. A computer system as defined in claim 24, wherein data exchange 
occurs without providing contextual data characteristics to a receiving data object. 

26. A computer system as defined in claim 25, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

27. A computer system as defined in claim 3, wherein data exchange occurs 
without providing contextual data characteristics to a receiving data object. 

28. A computer system as defined in claim 2, further including a plug-in 
manager object class that integrates service components into the application. 
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29. A computer system as defined in claim 28, wherein data service 
components interact with other components of the application to determine if a 
service is required and to determine parameters that are to be interchanged. 

30. A computer system as defined in claim 29, wherein the service 
determination occurs upon introduction of newly loaded components. 

31. A computer system as defined in claim 3, further including a translator 
facility that translates information concerning a data object into (1) attributes and 
metadata that define groups of data source and data consumer class attributes and (2) 
an object class that specifies at least one domain method for defining groups of data 
object attributes. 

32. A computer system as defined in claim 24, further including an 
InfoModel data object class. 

33. A computer system as defined in claim 27, wherein said contextual data 
characteristics are supplied by an InfoModel object. 

34. A computer system as defined in claim 33, wherein the InfoModel 
object receives a data source object for exposure to the data consumer objects, selects 
available attributes and methods of the received data source object for data 
characterization, and determines if the addition of attributes or methods to the data 
source object are appropriate. 
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35. A computer system as defined in claim 6, wherein the domain is defined 
using XML schema. 

36. A method of communicating data in a computer system that supports an 
object oriented programming environment and includes data storage or access to data 
storage containing data objects and specifications for a set of object classes that can 
be extended using object oriented principles to define an information handling 
application, the method comprising: 

receiving one or more data objects comprising a class of data source objects; 

representing the data source objects in accordance with an Information Model 
class of objects of a mediation layer that defines a data interface between the data 
source objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

37. A method as defined in claim 36, further including specifying at least 
one attribute/metadata object class that specifies attributes, including metadata, and 
that provides declarative and procedural information relating to attributes in said data 
object. 

38 A method as defined in claim 36, further including specifying a 
Relationship object class or classes that specify relationships between data source 
objects. 
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39. A method as defined in claim 36, further including specifying a Domain 
Policy or Domain object class or classes that specify a group of related attributes, 
methods, and semantic information that indicates data processing to be available for 
the specified attributes, including the specific intent of said attributes. 

40. A method as defined in claim 36, further including specifying an Event 
Change object class or classes that specify change event registration for detecting 
changes in the data objects. 

41 . A method as defined in claim 37, further including specifying a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 

42. A method as defined in claim 41, further including specifying a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

43. A method as defined in claim 39, further including specifying an 
attribute alias by a user to indicate any data source attributes of an attribute domain 
that may be subtitued with attributes of a different attribute domain. 

44. A method as defined in claim 37, wherein the attribute/metadata 
interface provides input/output functions for display and editing of the attribute during 
runtime. 
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45. A method as defined in claim 37, wherein the attribute/metadata object 
class is a FieldMetaData attribute that specifies processing criteria for an attribute of a 
data object. 

46. A method as defined in claim 37, wherein the processing criteria relates 
to a selected attribute of the data object for display processing. 

47. A method as defined in claim 38, wherein the indicated relationship 
may be resolved using a version of the Relationship object in cache of the computer 
system. 

48. A method as defined in claim 36, further including providing a 
collaboration facility that permits a user at a nework computer remote from the 
computer system to share a view of a data object at the remote network computer. 

49. A method as defined in claim 48, wherein the collaboration facility 
comprises a MetaView class of data objects that lightweight encapsulate elements of a 
data object for visual reconstruction on a display screen of the remote network 
computer. 

50. A method as defined in claim 37, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 

51. A method as defined in claim 39, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 
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52. A method as defined in claim 36, wherein data objects provided through 
the data interface comprise information that specifies data attributes, relationships, 
event broadcasting of changes in all registered data consumer objects, metadata for 
attributes that provide declarative and procedural information and/or input/output 

5 functions for display and editing, and related data items, and wherein the data objects 
can store references without direct access to a related data item. 

53. A method as defined in claim 52, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 

10 with respect to the contextual metadata. 

54. A method as defined in claim 36, wherein the mediation layer further 
includes object classes that include one or more methods that provide data exposure, 
and further including a Data Source Interface object class of data objects with 

15 methods that automatically determine which data exposure method will be used for 
data communications between the data source objects and data consumer objects. 

55. A method as defined in claim 54, wherein the determined data exposure 
method comprises data object reflection and introspection. 

20 

56. A method as defined in claim 54, wherein the data exposure methods 
include a data source object method that provides a standard interface, a data source 
object and a Translator object that maps an alternate data interface to the standard 
interface, and a data source object that is inspected by the computer system to 

25 determine available data fields which are thereby exposed to data consumer objects by 
the standard interface. 
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57. A method as defined in claim 36, wherein the data interface of the 
mediation layer provides a wrapper for the data objects. 

58. A method as defined in claim 57, wherein data exchange occurs without 
5 providing contextual data characteristics to a receiving data object. 

59. A method as defined in claim 58, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

10 60. A method as defined in claim 36, wherein data exchange occurs without 

providing contextual data characteristics to a receiving data object. 

61 . A method as defined in claim 36, further including a plug-in manager 
object class that integrates service components into the application. 

15 

62. A method as defined in claim 61, wherein data service components 
interact with other components of the application to determine if a service is required 
and to determine parameters that are to be interchanged. 

20 63. A method as defined in claim 62, wherein the service determination 

occurs upon introduction of newly loaded components. 

64. A method as defined in claim 36 , further including a translator facility 
that translates information concerning a data object into (1) attributes and metadata 
25 that define groups of data source and data consumer class attributes and (2) an object 
class that specifies at least one domain method for defining groups of data object 
attributes. 
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65. A method as defined in claim 57, further including an InfoModel data 
object class. 

5 66. A method as defined in claim 60, wherein said contextual data 

characteristics are supplied by an InfoModel object. 

67. A method as defined in claim 66, wherein the InfoModel object receives 
a data source object for exposure to the data consumer objects, selects available 

10 attributes and methods of the received data source object for data characterization, 
and determines if the addition of attributes or methods to the data source object are 
appropriate. 

68. A method as defined in claim 39, wherein the domain is defined using 
15 XML schema. 

69. A computer system that supports an object oriented programming 
environment, the system comprising: 

a processor that executes program instructions to provide the object oriented 
20 programming environment; and 

data store means for providing program instructions containing specifications 
for a set of object classes that can be extended using object oriented principles to 
define an information handling application with data objects comprising a class of 
data source objects and a class of data consumer objects, and a mediation layer that 
25 defines an interface between the data source objects and the data consumer objects to 
permit data information exchange between the two data object classes, such that the 
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class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 

70. A computer system as defined in claim 69, wherein the mediation layer 
5 defines a data interface that provides an information exchange standard between the 

data source objects and the data consumer objects. 

71 . A computer system as defined in claim 70, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 

10 metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

72. A computer system as defined in claim 70, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 

15 data source class objects. 

73. A computer system as defined in claim 70, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 

20 available for the specified attributes, including the specific intent of said attributes. 

74. A computer system as defined in claim 70, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

25 

75. A program product for use in a computer system that executes program 
instructions recorded in a computer-readable media to perform a method for 
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information exchange in a computer system that supports an object oriented 
programming environment and includes access to data storage containing data 
objects, the program product comprising: 
a recordable media; and 

a program product of computer-readable instructions executable by the 
computer system to perform a method comprising: 

receiving data specifications for a set of object classes that can be extended 
using object oriented principles to define an information handling application, 
wherein the extended objects provide an information handling application that can 
receive one or more data objects comprising a class of data source objects, and 
represent the data source objects in accordance with an Information Model class of 
objects of a mediation layer that defines a data interface between the data source 
objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

76. A program product as defined in claim 75, wherein the method further 
includes specifying at least one attribute/metadata object class that specifies attributes, 
including metadata, and that provides declarative and procedural information relating 
to attributes in said data object. 

77. A program product as defined in claim 75 , wherein the method further 
includes specifying a Relationship object class or classes that specify relationships 
between data source objects. 
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78. A program product as defined in claim 75, wherein the method further 
includes specifying a Domain Policy or Domain object class or classes that specify a 
group of related attributes, methods, and semantic information that indicates data 
processing to be available for the specified attributes, including the specific intent of 

5 said attributes. 

79. A program product as defined in claim 75 , further including specifying 
an Event Change object class or classes that specify change event registration for 
detecting changes in the data objects. 

io 

80. A method of operating a computer system to execute an information 
handling application in an object oriented programming environment and to receive 
data from a class of data source objects and provide a class of data consumer objects 
with data, the method comprising: 

15 selecting available attributes and methods of a data source object for 

characterization; 

determining attributes or methods to be added to the data source object during 
application execution; and 

receiving the data source object and determining whether to expose or hide 
20 available attributes and methods of the object from data consumer objects, wherein 
data communications between the two data object classes is supported, such that the 
class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 
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Figure 6B 
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Figure 9 



getAttributesQ 


References 


Referrers 


Members 


com.xis.domains.display.DisplayDomain.displayName 
com .xis.test. Person. DOB 
com.xis.test.Person.SSN 
com. xis.test. Person. name 


None 


None 


None 
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1102 



1104 



1106 



Consumex.. 



; ^ 5 /display object at given location 



8 : display object moving at speed 



1 1 : plot numerical time duration 



<c 



[ includes OeoDomain ] : 3 : get GeoPosition 



" <<telu?n>> " 



[includes MovementDomain] : 6 : get Speed 



k- . 

* «return*> i 

i 

I includes TemporalDomain ] : 9 : request computeExistenceDurationQ 



la.:- - . 

<<return» 



Figure 1 1 
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Package com.xis, types 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of those types. 



See: 



Interface Summary 


DataTest 


The DataTest interface specifies methods for Object validation. 


UXmTypxlQ 


This interface defines the 10 for HTML. 




i iic o uiTUTia j. y c unc u ion uiLciiauc ucuucj generic suiTuTiary Luriuiionaiiiy uaoeu upon provioeQ 
input data values. 


SjdngJjijiefO 


The SwingTypelO interface allows for the use of both swing editors, allowing swing 
components to edit an object, and swing Tenderers, which know how to render these objects in 
a swing environment. . 


TextTypelO 


The TextTypelO interface provides a means of formatting objects in a textual fashion, as well 
as parsing- text from which an object is created. 


Typed Value 


The TypedValue interface is used to hold an object that carries its own TypeMetaData with 
it. ' 


Type Editor 


The TypeEditor interface defines methods for editing attributes provided by the types 
implemented within this package. 


TypcLQ 


The TypelO interface provides a common base from which other TypelOs can extend, such as 
HTMLTypelO, SwingTypelO, etc. 


TypeMetaData 


The TypeMetaData interface defines generic type accessors for object comparing, editing, 
formatting, rendering, and validation. - 


TypeMj^DMqJEactgsy 


The TypeMetaData Factory interface defines a class that can, create TypeMetaData for a . 
given Class Type. '> • 


TvpeRenderer 


The TypeRenderer interface defines methods for rendering attributes provided by the types 
implemented within this package. 


ValidTestProxy 


The ValidTestProxy interface 


WMLTvpeEditnr 


The WMLTypeEdi tor interface defines methods for rendering attributes provided by the types 
implemented within this package. 


WMUypelO 


This interface defines the 10 for WML format. 


WMLTyp eRenderer 


The WMLTypeRenderer interface defines methods for rendering attributes provided by the 
types implemented within this package. 


mLTypelQ 


The XMLTypelO interface provides a means of formatting objects in a XML textual fashion, as 
well as parsing XML text for creating an object. 
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Class Summary 


AbstractDataTest 


The AbstractDataTest class provides a default implementation of test 
(Object) 


A b sir a c tjy p e M e t a Data 


Abs-tractTypeMetaData provides a partial implementation of 
TypeMetaData to relieve the XIS developer from explicitly implementing 
irrelevant methods. 


AreaOfUncertaintyTypeM^aData 


AreaOfUncertamtyTypeMetaData is a type oDjeci mat supports 
AreaOfUncertainty o.bjects. 


ArrayListTypeMetaData 


ArrayListTypeMetaData is a type object that supports 
Java. util.ArrayList objects. 


ArravTypeMetaData 


ArrayTypeMetaData is a type object that supports Java. 1 ang. reflect. Array 
objects. 


BeanTvpeM eta Data 


_ _ J- .-, Hi/ma rvUi 5 o.r»f fH*at et»nnr\r"ts fVru/7 n p /7 !•? c nhlPCt^ 

BeanTypeMe taDa ta is a type oojeci mai suppuria juvu.yeu/u uujck-l^. 


BooleanTvDeM eta Data 


The BooleanTypeMetaData is a type object that' supports Boolean objects. 


BooIeanTvpeMetaDataFactorv 


A BooleanTypeMetaDataFactory can create a 
BooleanTypeMetaData for given booleans. 


CachedTvpeMetaData 


CachedTypeMetaData is a type object that simply delegates all - 
TypeMetaData calls to another TypeMetaData. 


ClassificationTypeMe t a Da t a 


Classif icationTypeMetaData is a type object that supports 
Classification objects. 


Collect ionsTy p eM eta Data 


CollectionsTypeMetaData is a type object that supports Collection 
objects. 


ColorTvpeMetaData 


The ColorTvpeMetaData class implements i ypeivieiautiia iur ^uiut 
objects. f 


Qp lo rTy peM eta Da ta Facto ry 


A ColorTypeMetaDataFactory can create a ColorTypeMetaData for 
a given Color object. 


ConversionNumericTypeMetaData 


A generic Numeric lypeivietajjata ror converting uom unc mm iu auuuict. 


Cu rrencvTvnetVI eta Da ta 


CurrencyTypeMetaData is a type object that supports Number objects 
that represent Currency values. 


DateTimeTypeMetaData 


DateTimeTypeMetaData is a type object that supports Date objects. 


DateTimeTypeMetaDataFactpry 


A DateTimeTypeMetaDataFactory can create a 
DateTimeTypeMetaData for given Date objects. 


PjiscreieRa^ 


DiscreteRangeStringTypeMetaOata is a type object that supports 
Siring objects with discrete ranges. 


DispIavLahelTypeMetaData 


DisplayLabelTypeMetaData is a type object that supports supports 
DisplayLabel objects. ' 


DTGTypeMetaData 


DTGTypeMetaData is a type object that supports Date objects. 


EnumerationType 


Class to implement an enumeration in Java. 


EnumerationType MetaData 


The EnumerationTypeMetaData class is used to represent integer 
constants as strings to the user. 


FontTypeMetaData 


FontTypeMetaData is a type object that supports Font objects. 


HashMapTypeMetaData 


HashMapTypeMetaData is a type object that supports jov a. un7.tf^/iA*ap 
objects. 
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HashSetTypeMetaData 


HashSetTypeMetaData is a type object that supports java.utii.HashSet 
objects. 


I co nS h a p_eTy peMeta D ata 


IconShapeTypeMetaData is a type object that supports IconShape 
objects. 


teQnTy.pejM.eta.Da ta 


IconTypeMetaData is a type object that supports Icon objects. 


Lin ked Lis tTxpeM eta Daja 


LinkedListTypeMetaData is a type object that supports 
java.utiLLinkedList objects. 


UsJTypeM eta Da ta 


ListtypeMetaDaca is a type object that supports javautil.List objects. 


MQUs„ejyiapP.ro;xy 


The MouseMap Proxy class allows TypeEditors access to the map without 
requiring them to having any compile time knowledge of the map's, 
existence. 


Nu m berCo m p.a_r.at_or 


An implementation of the Comparator interface that compares two objects 
that extend Number, or that both implement Comparable, with the class of 
one assignable from the other. 


NumericTvpeMetaData 


NumericTypeMetaData ^ is a type object that supports Num b er objects. 


NumericTvpeMetaDataFactorv 


A NumericTypeMetaDataFactory can create NumericTypeMetaDa ta 
for a given class type or method return type. 


Qbj ectTypeMeta Data 


Ob j ectTypeMetaData is a type that supports a simple Object and is 
provided to quickly add arbitrary attribute types to a Data Source Interface 
without writing a more specific type handler. 


PercentTvnefVTpf nDnta 


PercentTypeMetaData is a type object that supports Number objects that 
represent Percent(%) values. 


ProbabilitvTvpeMetaData 


ProbabilityTypeMetaData is a type object that supports Number 
objects that represent Probability values. 


Re n a m edTy pjeM e t aData 


RenamedTypeMet aData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getNameQ, which is overridden with 
the given value. 


ResjzedJ^extTyReMe^ 


ResizedTextTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getPixelWidthQ, which is overridden 
with the given value. 


R p^n it rr*f»s 


The Resources class is automatically generated and must be public, but it 
is intended to be used only by Java's internationalization support classes. 


SrnartDurationTypeMetaData 


A SmartDurationTypeMetaData for converting from one time unit to 
another based on the magnitude of the duration value. 


^ringTjpiLMeJaData . 


StringTypeMetaData is a type object that supports String objects. 


Sinn g!yp_eMeta D a taFa cto ry 


A StringTypeMetaDataFactory can. create a StringTypeMetaData 
for a given String object. 


TextTy peM_ etgDa ta 


TextTypeMetaData is a type object that supports Text objects. 


JLj.- VSrMjL.4jMsL.*.j p vJjAejLa jyj*ia 


TypedValueTypeMetaData is a type object that supports supports 
TypedValue objects. 


XxP c^Qi i orpe 4. n v-o.n t ex.LW JUL" o u p port 


The TypeEditorBeanContextChildSupport class handles most of the 
responsibilities of a TypeEditor and a BeanContextChild. 


TvoeEditorSupport 


The TypeEditorSupport class handles most of the responsibilities of a 
TypeEditor. 


TvpelOPIugeableService 


The TypelOPluggableService class is responsible for loading TypelOs. 


TypelORegistry 


The Type IORegis try class is a registry for different implementations of 
Type 10 classes. 



f\G. tZ-C 
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TvpelOSupport 


The TypelOSupport provides support for TypeM eta Data's getTypelO 
methods. 


Ty peM e taDa ta D elegatg r 


TypeMetaDataDelegator is a type object that simply delegates ali 
TypeMetaData calls to another TypeMetaData. 


TypeMetaDataFactoryPluggableService 


The TypeMetaDacaFactoryPLuggableService class is responsible for 
loading TypeMetaDataFactories. 


TypeMetaData FactorvStore 


This Class stores TypeMetaDataFactories. 


TvpePreferences 


This class is used by TypeMetaData instances to pass .information about 
preferred TypeMetaData objects. 


I* pes 


The Types class is a holder class for the RESOURCES global variable for 
resource properties of the com.xis. types package. 


URLTjpeMetaDaJa 


URLTypeMetaOata is a type object that supports URL objects. 



Exception Summary 


NoSuchEnumerationException 


Class to implement an enumeration exception in Java. 


ParseFailed Exception 


A ParseFaiiecLException is thrown (typically by TypelO objects) when it is not 
possible to parse a given String as desired. 


TestFailedException 


The TestFailedException is thrown from the "testQ" method of a DataTest 
subclass when the value fails the test. 



Package com.xis.types Description 

This package contains classes that provide several standard TypeMetaData classes for describing types 
constraints, and for rendering and editing values of those types. 
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Q Start ^ 
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Figure 14 
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Figure 15 

HelloWorldjava 

/* XIS Tutorial standalone sequence example 1 data class. */ 

public class HelloWorld { 
private float value = 1 ,5f; 

public String toString() { 
return "HelloWorld!"; 

} 

public int getlDQ { 
return 5; 

> 

public float getVaiue() { 
return value; 

} 

// uncomment this to make "value" editable 
/* 

public void setValue(float value) { 
this.value = value; 

} 

*/ 

} 
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Figure 16A 



1602 



TestHarness.java 

/* XIS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax.swing JFrame; 
import java.awt.event.WindowAdapter; 
import java.awt.event.WindowEvent; 
import com.xis.propertysheet.PropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; r 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 

public class TestHarness { 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModeLsetStartingPluglnManager(false); 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawDataltem(new HelloWorldQ); 



V 1604 



1606 



// add listener for 'OK,' 'cancel, 1 or close, which generate 'close' events a 
properties.addUIBeanListener( 

new UIBeanAdapter() { I 

public void closed(UIBeanEvent event) { ■ r I 608 

System. exit(0); 

} 

} 

); 



// a top-level frame to hold our property sheet infobean 
JFrame frame = new JFrame("HelloWorld Properties");. 
// add a listener for window closing 
frame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System. exit(0); 

} 

} 

); 



r 1610A 
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Figure 16B 

Continuation of TestHarnessjava 



// stick the bean in the frame and display it 

frame.getContentPane().add(properties); 

frame.pack(); 

frame.setVisible(true); 



> 1610B 



} 

} 
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Figure 17 
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Figure 18A 

HelloWorld.java 

/* XIS Tutorial standalone sequence example 2 data class. */ 
/*{*/ 

import java.awt.Color; 

import java. beans. PropertyChangeSupport; 

import java.beans.PropertyChangeListener; 

/*}*/ 

public class HelloWorld { 

/*{*/ 

private int value =1; 

private Color myColor = Color.green; 



f //this member class helps distribute property change events. within XIS 
private PropertyChangeSupport propertyChangeSupport = 

new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangel_istener I) { 
propertyChangeSupport.addPropertyChangeListener(i); 

} 

public void removePropertyChangeListener(PropertyChangel_istener I) { 
propertyChangeSupport.removePropertyChangeListener(l); - 

} 



public String toString() { 

return "A HelloWorld Object"; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

*}7 

public int getlDQ { 
return 5; 

} 
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Figure 18B 

Continuation of of HelloWorld.java 



public /*{*/ int /*}*/ getVa!ue() { 
return value; 

} 

/*{*/ 

public void setValue(int value) { 

// only update and fire property change if this is really a change 
if (this. value != value) { 
int oldValue = this.value; 
this.value = value; 

// fire property change event to notify other XIS objects 7 n 

propertyChangeSupport.firePropertyChangeCValue", oldValue, value); p** * 
} ~ J 

} 

public Color getMyColorQ { 
return myCoior; 

} 

public void setMyColor(£olor my Color) { 

// only update and fire property change if this is really a change 
if (this.myColor != myCoior) { 

Color oldMyColor = this. myCoior; 
this.myColor = myCoior; 

// fire property change event to notify other XIS objects ~) . > 
propertyChangeSupport.firePropertyChange("myCo!or ,, 1 V \ft°nT 

oldMyColor, myCoior); J 

} . 
./*}*/ 



} 
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Figure 19A 



TestHarnessjava 

/* XIS Tutorial standalone sequence step 2 XIS interfacing. */ 

import javax.swing.JFrame; 

import java.awt.event.WindowAdapter; 

import java.awt.event.WindowEvent; 

import com.xis.propertysheetPropertySheetlnfoBean; 

import com.xis.ui.UIBeanEvent; 

import com.xis.ui.UIBeanAdapter; 

import com.xisJeifJm.BaselnfoModel; 
/*{*/ 

import jdass.chartJCChart; 
import com.xis.plot.PlotlnfoBean; 
import com.xis.plotchartviews.LeifChartView; 

i*yi 

public class TestHarness { 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

HelloWorld hello = new HelloWorldQ; 

II a property sheet infobean to display HelloWorld's attributes /• \ * 

PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties. addRawDataltem(hello); 

// add a listener for 'OK 1 or 'cancel 1 , which generate 'close* events 
properties. addUIBeanListener( 
new UIBeanAdapterQ { 

public void closed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

); 
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Figure 19B 

Continuation of TestHarness.java 



/*{*/ 



/*}*/' 



// a top-level frame to hold our property sheet infobean ^ 
JFrame propertySheetFrame = new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it x 
propertySheetFrame. getContentPane().add(properties); V 
propertySheetFrame. packQ; 
propertySheetFrame.setVisible(true); 

// now we create a plot infobean to plot HelloWorld's numeric attribute 
PlotlnfoBean plot = new PIotlnfoBeanQ; 
plot.addRawDataltems(new ObjectQ { hello }); 
plot.setChartType(JCChart.BAR); 

// the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING JBAR, though not all will make sense in this example 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFramefHelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPane().add(plot); 
plotFrame. pack(); 
plotFrame. setVisible(true); 
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Figure 20 
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Figure 21 

HelloWorld.java 

/* XIS Tutorial standalone sequence step 3 data class. */ 
import java.awt.Color; 

// (property change support moved to HelloWorldTranslator) 

public class HelloWorld { 
private int value = 1 ; 
private Color myColor = Color.green; 

public String toString() { 

return "A HelloWorld Object"; 

} 

public String getGreetingQ { 
return "Hello World!"; 

} 

public int getlDQ { 
return 5; 

} 

. public int getValue() { 
return value; 

} 

./*{*/ 

public void setValue(int value) { 
. // all the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation (unless nonXl£ 
// components need to listen to PropertyChanges) 
this, value = value; 

} 

/*}*/ 

public Color getMyColor() { 
return myColor; 

} 

/*{*/ 

public void setMyCofor(Coior myColor) { 
// just need to set the value (see setValue()) 
this. myColor = myColor; 

} 

/*}*/ 
} 
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Figure 22A 



1? 



HelloWorldTranslator.java 

/* XIS Tutorial standalone sequence step 3 data translator class. */ 
/*{* / 

import com.xis.leif.im.AttributeGetRequest; 

import com.xis.leif.im.AttributeSetRequest; 

import com. xis.leif.im. Domain; 

import com.xis.leif.im.TransIator; 

import com.xis.ieif.im.FieldMetaData; 

import com.xis.domains.display.DisplayDomain; 

import com.xis. domains. movement.MovementDomain; 

import java.awt Color; 

public class HelloWorldTranslator extends Translator { 

. // the domains from which canned attribute metadata will be taken 
// NOTE, if an attribute appears in the methods below but its domain 
// is NOT listed here, THE ATTRIBUTE WILL BE IGNORED BY XIS 
private static final DomainQ baseDomains = new DomainQ { 
DisplayDomain.getDomainO, MovementDomain.getDomainQ 

}; 

77 store info about the fields, such as whether they are preferred or not 
private FieldMetaDataf] fieldMetaDataArray; 

// Return the Domains that describe the Attributes, 
public DomainQ getBaseDomainsQ { 
return baseDomains; 

} 

// this method returns info on each field defined in the methods below 
/public FieldMetaDataQ getFieldMetaDataArrayO { 

if (fieldMetaDataArray == null) { 

// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.displayName); 

FieldMetaData pencolor = new 

FieldMetaData(DisplayDomain.penColor); 

FieldMetaData speed == new 

FieIdMetaData(MovementDomain. speed); 

FieldMetaData course = new 

FieidMetaData(MovementDomain. course); 
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} 



Figure 22B 

Continuation of HelloWorldTranslatorjava 

// attributes are visible ('preferred 1 ) by default; this 
// turns this off for the course attribute 

course.setVisibilrty(false); f 
// the order we put the attributes in here determines the order y 2-2-^ ^ 
// they appear in tables or property sheets 
fieldMetaDataArray = new FieldMetaDataQ { 
dispname, speed, course, pencolor 

}; 

} 

return fieldMetaDataArray; 



/////////////////////////////////////////////////////////////////// ~*\ 
// the following methods expose attributes of the HelloWorld class; s 
II instead of calling the class methods directly, XIS will access 
// everything through this translator class 

IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIl 

public String getDisplayName(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequest,getRawDataltem()).toStringO; 

> 

public Color getPenColor(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequestgetRawDataltem()).getMyColor(); 

public void setPenColor(AttributeSetRequest attributeSetRequest, 
Color penColor) { 
HelloWorld helloWorld = (HelloWorld) 

attributeSetRequest.getRawDataltem(); 
Color oldPenColor = helloWorld.getMyColorQ; 
if (!penColor.equals(oldPenColor)) { 
helloWorld. setMyColor(penColor); 
// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataltem0.fireAttributeChanged( 
DisplayDomain. penColor, oldPenColor, penColor, true); 
} - 

} 

public double getSpeed (AttributeGetRequest attributeGetRequest) { 
return (double) ((HelloWorld) 

attributeGetRequest.getRawDataltem()).getValue(); 

} 
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Figure 22C 

Continuation of HelloWorldTranslator.java 

public void setSpeed(AttributeSetRequest attributeSetRequest, 
double speed) { 
HelloWorld helloWorld = (HelloWorld) 

• attributeSetRequest.getRawDataltemO; 
Double oldSpeed = new Double((double)helloWorld.getValueQ); 
if (oldSpeed.doubleValueO != speed) { I ■%x\Z- 

. helloWorld.setValue((int)speed); 
// fire property change event to notify other X1S objects 
a ttributeSetRequest.getBaseDataltem().fireAttributeChanged( 
MovementDomain.speed, oldSpeed, new Double(speed), true); 

} 

// this is a dummy attribute to demonstrate field metadata ( qjvo ft 

public double getCourse(AttributeGetRequest attributeGetRequest) { f 
return (double) 0; 

} 

/*{*/ 

// uncomment this to allow reflection to expose additional attributes 
// (see documentation under "Fooling Around") 
// public HelloWorldTranslator() { 

// introspectExcept(new StringQ {"value", "myColor"}); 

7/ } 
/*}*/ 

} ■ 
/*}*/ 
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Figure 23A 

TestHarness.java 

/* XIS Tutorial standalone sequence step 3 XIS interfacing. */ 

import javax.swing. JFrame; 
import java.awt.event.WindowAdapter; 
import java.awt.event.WindowEvent; • 
import com.xis.propertysheet.PropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 
import jciass.chart.JCChart; 
import com.xis.plot.PlotlnfoBean; 
import com.xis.plot.chartviews.LeifChartView; 
/*{*/ 

import com.xis.leif.im.TranslatorRegistry; 
import com.xis.leif.im.LeifDataltem; 
import com.xis.leif.im.lnfoModel; 
import com.xis.leif.im.BaselnfoModel; 
import com.xis.domains.movement.MovementDomain; 
import com.xis.domains.movement.MovementDomainWrapper; 
import com.xis.leif.im.LeifDataltemDelegator; 
import java.lang.reflectlnvocationTargetException; 
import com.xis.leif.im.UndefinedLeifAttributeException; 

ryt 

public class TestHamess { 
/*{*/ 

protected static LeifDataltem leifHello; 
static { 

// Register the translator for HelloWorld. In fact this is really 
// only necessary when we have not followed the standard naming 
// convention (see docs), but it can't hurt. 

TranslatorRegistry.getTransIatorRegistry().registerObjectSchema( 
HelloWorld. class, HelloWorldTranslator.class); 

} 

/*}7 

public static void main(String[] args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

HelloWorld hello = new HelloWorldQ; 
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Figure 23B 

Continuation of TestHarness.java 

// a property sheet infobean to display HelloWorlcTs attributes 
PropertySheetlnfoBean properties = new PropertySheetInfoBean(); 
properties.addRawDataltem(hello); 

// add a listener for 'OK 1 or 'cancer, which generate 'close' events 
properties. addUIBeanListener( 
new UIBeanAdapterQ { 

public void closed(UIBeanEvent event) { 
System. exit(0); 

} 

} 

); 

// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFrame("HelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame. addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System. exit(0); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame. getContentPaneQ.add(properties); 
propertySheetFrame. pack{); 
propertySheetFrame.setVisible(true); 
// now we create a plot infobean to plot HelloWorld's numeric attribute 
PlotlnfoBean plot = new PlotlnfoBean(); 
plotaddRawDataltems(new ObjectQ { hello }); 
plot.setChartType(JCChart.BAR); 

// the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_J3AR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 

// if we do, this must consist of the attribute name preceded 

// by the fully-qualified classname which ORIGINALLY DEFINES 

// the attributeDescriptor — i.e., using "HelloWorld.speed" 

// here will NOT work! If the descriptor is not defined in a 

// domain or translator class, then it will have been defined 

// dynamically through introspection when the first instance 

// of the data item is dropped into an XIS InfoBean. 

plot.setYAxisAttribute( 

"com. xis. domains. movement.MovementDomain. speed"); 
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Figure 23C 

Continuation of TestHarnessjava 

plot.setDynamicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-level frame as before to hold our plot infobean 
JFrame plotFrame = new JFrame("HelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame. getContentPane().add(plot); 
plotFrame. pack(); 
plotFrame.setVisible(true); 



// create a leifDataltem version of hello and start a thread that 
// will increase it 
leifHello = 

BaselnfoModeLgetBaselnfoModelQ.getLeifDataltem(hello); 
new Accelerate(); 

/*}*/ 

} // main 

} 



/*{*/ 

// thread to update the speed attribute on the leifHello instance we created 
class Accelerate extends Thread { 

public AccelerateQ { 

super("Acce!erator Thread"); 
start(); 

} 

public void run() { 

// wrap the LeifDataltem leifHello in a convenience wrapper that 
// gives access to attributes within that domain, if they exist 
MovementDomainWrapper helloMovementWrapper = 
MovementDomain.takeWrapper(TestHarness.leifHello); 
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Figure 23D 

Continuation of TestHarness.java 



while (true) { 

// sleep for 0.5 seconds, then... 
try{ 

sleep(500); 
} catch (InterruptedException e) { 

System.exit(l); 

>' 

// ..update the speed attribute 
try{ 

helloMovementWrapper.setSpeed( 

helloMovementWrapper.getSpeed()+1); 

} catch (UndefinedLeifAttributeException ulae) { 

// exception if this data item doesn't have this attribute 
System.exit(l); // usually we would do something better 

} catch (InvocationTargetException ite) { 

// sweep up any exception tossed by the underlying raw item 
System.exit(l); // usually we would do something better 

} // while 
} // run() 

}; 

/*}*/ 
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Figure 24A 
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Figure 25A 

HelloWorld.java 

/* XIS Tutorial standalone sequence step 4 data class. */ 

import java.awt. Color; 
/*{*/ 

import com.xis.leif.im.FieldMetaData; 
import com.xis.domains.display.DisplayDomain; 
import com.xis.domains.movement.MovementDomain; 
import com.xis.leif.im.Domain; 
import com.xis.leif.im.AttributeGetRequest; 
import com.xis.leif jm.AttributeSetRequest; 
import com.xis.leif.im.AttributeDescriptor; 
import java. beans. PropertyChangeSupport; 
import java. beans. PropertyChangeListener; 
/*}*/ 

public class HelloWorld { 

private int value = 1 ; 
private Color myColor = Color.green; 

/*{*/ 

public static AttributeDescriptor getDisplayNameQescriptor() { 
return DisplayDomain.displayName; 

} 

public static AttributeDescriptor getSpeedDescriptor() { 
return MovementDomain. speed; 

} 

public static AttributeDescriptor getPenCoforDescriptorQ { 
return DisplayDomain.penColor; 

} 

/*}7 

/*{*/ // this property change support code as in step 2 /*}*/ ~"\ 
// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 

new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.addPropertyChangeListener(l); 

} 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.removePropertyChangeListener(l); 



WO 02/46916 



40/90 



PCT/US01/48418 



Figure 25B 

Continuation of HelloWorldjava 

public String toStringO { 

return "A HelloWorld Object"; 

} 

public String getGreetingQ { 
return "Hello World!"; 

} 

public int getlDQ { 
return 5; 

} 

public int getValueQ { 
return value; 

} 

/*{*/ // this function as in step 2 /*}*/ 
public void setValue(int value) { 

// we only want to update and fire property change if really changes 
if (this.value != value) { 
int oldValue = this.value; 
this.value = value; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("vaiue", oldValue, value); 

} 

/*{*/ 

// "myColor"-related methods changed to expose "penColor" instead 

public Color getPenColorQ { 
return myColor; 

} 

public void setPenColor(Color penColor) { 

// we only want to update and fire property change if really changes 
if (penColor != this. myCoior) { 

Color oldPenColor = this.myColor; 

this.myColor = penColor; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChangefpenColor", 

oldPenColor, penColor); 

} 

} 
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Figure 25C 

Continuation of HelloWorldjava 

// expose toString() return under a new name 
public String getDisplayNameQ { 
return toString(); 

} 

// expose "value" under a new name 
public double getSpeed() { 
return (double) getVaiue(); 

} 

public void setSpeed(double speed) { 

// we only want to update and fire property change if really changes 
Double oldSpeed = new Double((double)this.getValue()); 
if (speed != oldSpeed. doubleValue()) { 
setValue((int)speed); 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("speed", oldSpeed, 

new Double(speed)); 

} 

/*}*/ 
./*{*/ 

// store info about the fields, such as whether they are preferred or not 
private static FieldMetaDataQ fieldMetaDataArray; 

// this method returns info on each field defined in the methods below 
public static FieldMetaDataQ getFieldMetaDataArrayQ { 

if (fieldMetaDataArray == null) { 
// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.displayName); 
FieldMetaData pencolor = new 

FieldMetaData(DisplayDomain.penColor); 
FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 
// could customize the field metadata here 
fieldMetaDataArray = new FieldMetaDataQ { 
dispname, speed, pencolor 

}; 

} 

return fieldMetaDataArray; 

} 

/*}*/. 
} 
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Figure 26 
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Class ContentlnfoBean 

l ... 

+ - ~ iA.y a w t . Compo nent 
I 

+ - - lava aw t ... Co ri t a in e r 

I • " * • 

+ — j ay ax . sw ing ._J Comp onent 

I ' 
+- - j ayax,. swing . JPanel 

I . 

+ — com. xis . ui Abs trac t U IB ean 

• I 

» 

■l---con: . xis . infobeans . content . ContentlnfoBean 

All Implemented Interfaces: 

Accessible , BeanContextChildQwner . BeanContextChiidOwnerDelegator , BeanContextProxv . 
BeanCo ntextServ icesQwnerDeleg at or. Clip board User, Dat aItemSink T ImageObserver, Men uConta iner. 
. Serializable . StateSavable . UIBean 



public class ContentlnfoBean 
extends Datal.te mS ink U IB ean 

implements ClipboardUser . 

The ContentlnfoBean class is a visual component that displays the contents of a raw data item. If no contents are 
available, it defaults to a split pane containing the JAF menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text, or an image. Multimedia support will soon be added. 

Author: I 

Jaime Garcia, Polexis, Inc. 
See Also: 

Serialized Form 



Inner classes inherited from class javax.swing.JPa_neJ 



JPanel . A ccess i hi e JPanel 



Inner classes inherited from class javax.swing.JComponent 



JComRongJlSL.J\c_c es s i b 1 e JComponen t 



Inner classes inherited from class j a va.awt.Con tamer 



Con, t a i n e r^Acgj essib 1 e AWTCon t a i ne r 
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Inner classes inherited from class java.awt. Component 
Component .AccsssibLeAWTConmonent 



Field Summary 


s t a c ic XjttjBd&a s.ou £sa&& adi ? 


RESOURCES 




localized resources for this view object. 



Fields inherited from class com.xis.ui.AbstractUlBean 
uibeanListener 



Fields inherited from class javax.swingj^omppngnt 

accessibleContext . liste ne rLi.st , TOOL _T I P_T EXT _KE Y , ui , UNDEFINED^COND ITION . 
^^^^^^^^XQQ^SU^^l^Mlt WHEN^F OCUS ED, WHEN^I N JFQg USE D^W.I N DOW ' 



Fields inherited from class java.awt.Comppn en t 

BOTTQM^ALIGNME NT , CENTER_AL I GNMSNT , LE FT_ALIGNMENT , R I GHT_ ALIGNMENT , TO P AL I GNMENT ' 



Fields inherited from interface java.awt.image. ImageQbserver 

ABORT, ALLBIT5, ERROR, FRAMEBITS , HEIGHT, PROPERTIES/ 5QMEBITS, WIDTH 



Constructor Summary 

Contentlnf oBean { ) 

Default constructor that creates an empty ContentlnfoBean. 



Method Summary 


void 


addRawDataltem. (Obi ect rawDataltem) 

Load the raw data item into the ContentlnfoBean. 


void 


addRa.waa.taI terns (Ob ject fl cawData Items \ 
Add the raw data items in the array. 


boolean 


canClear ( ) 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canClear (Obi ect M items) 

Return true if the specified items can be cleared. 


boolean 


cartCopY { ) 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canCpEx ( Qfeject ( 1 items) 

Return true if the specified items can be copied. 


boolean 


canCut U 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canCut (Obi ect [ ] items) 

Return true if the specified items can be cut. 


boolean 


canPaste ( ) 

Return true if the ContentlnfoBean can paste new objects, false if not. 


boolean 


canSelectAllO 

Return true if the ContentlnfoBean can select all objects. 
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boolean 


aanSelectWane ( ) 

Return true if the ContentlnfoBean can un-select all objects. 


.void 


clear ( ) , , 

Notify the ContentlnfoBean to remove the current raw data item only if it is selected 


voi.d 


clear {Object [ ] items) 
Clears the ^iven items 


void 


claarAl 1 ( ) 

Removes the currentlv loaded obiect 


boa Lean 


contains (Obiect ( 1 items) 

Return trup if th i «? frtntpntlnrnPtean rrmtn!n«5 rr)I f-Hf* nhipffc r\f fVn» cri'v^n s»iT5n/ 
iXwwUi.j ii uc ii una \^vji i uwii in nu ljg&i i LUiuauij Liu tliC UUJCulj \Ji tf]C glYCn aSTay. 


boolean 


con tains Component (Component component ) 

Check if thr given component is contained by this InfoBean 


void 


copy (Clipboard clipboard) 

Called to invoke this ContentlnfoBean's copy action, which is to copy all selected data 
to the Clipboard. 


void 


copy (Cj._ip_boax4 clipboard, Obiect [ 1 items) 
Copies the given items into the Clipboard. 


. protected void 


crsateContent ( ) 

Method called when there is no content to display for a raw data item. 


void 


cut(Clipboard clipboard) 

Cut selected items from the ContentlnfoBean and post- them into Clipboard. 


void 


cut(Cli.pboard clipboard, Obiect M items! 

Cut the given. items from the ContentlnfoBean and post them- into the given Clipboard 
only if they occur in the ContentlnfoBean. 


protected .Container 


qetContainerFarContent (int index ) 

Get a container with the contents of the content object at the given index, or null if the 

rnnfpnt t"unf» ic nnt ci innnrfpH 

LUliLwIU ljr[JC 11UL JU[J{JUI LCU. 


Object 


getCpntarita ( ) 

Fetch the currectly loaded raw data item 


JAFAndP rooertvComoanon it 


cret JAFAndP roper tyC amp onent ( ) 




Get the JAFAndPraperty component used by the ContentlnfoBean to display the 
contents ior raw aaia iienus tnac nave noining eise to uispiay. , 


JMenu 


ce tLaifPataltemMenu [ Leif Dataltem datalteni, boolean showCut Pas tel terns ) 

T? i r-rt f Vi *» rl^H ! *■ <»m m cm i fnr n T lafn lt*M A tctta 1 li> c ■» ,- f pi A 1 m i fl""\*afr«i 1 t-»m\ 

ivtiurn tnc uaia ucra menu iur a i^cii—jaiaiicui ^usually enc sciccica LiciLL/aLaiLcnij. 


TvoedResQU eceQundle 


R pftim the RpgourrpBundlp frirthi 1 ? rnnhpnt-Tn fnR«an 


RJsiflC.HI] 


g et S el e c tedOh j ects ( ) 

Get an array of selected objects. 


void 


in£ oMpdelChanged ( ) 

Messaged to indicate an InfoModel change for this LnfoBean or one or more of its 
LeifDataltems. 


boolean 


isCreatingContent ( ) 

Check whether default content creation is set. 


boolean 


IsDragSnablad ( ) 

Return true if the default Drag support is enabled. 


boolean 


isDropEnabled { ) 

Return true if the default Drop support is enabled. 
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boolean 


i s S a 1 e ctad ( ) 

Check the selected state of the content object, if there Is currently one loaded. 


boolean 


isXISNatif ying ( ) 

Check whether the ContenttnfoBean is updating based on XJS events and is notifying 
XIS of raw data item attribute changes • 


void 


paste {Clipboard clipboard) 

Paste the data Objects from the given clipboard. 


void 


removeAllRawDatalteros ( ) 

Remove all of the raw data items that are currently loaded 


void 


.. cemoveRawDa tal tem (Qbjjsct rawDatal tern) 

Remove the given raw data item if it is the currently loaded raw data item 


void 


'ramovaRawDataltams (Obiect [ ] rawData 1 1 ems 1 
Remove the raw data items in the array. 


void 


selectAll ( ) 

Set the selection state of the object to true. 


void 


selsctMone () 

Set the selection state of the object to false. 


void 


setCceateCpntent (boolean create) 

Set whether content should be created for objects that do not have any displayable 
content, via a JAFAndPropertyComponent. 


void 


setDragEnabled (boolean enabledrag ) 
' Set the status of the default Drag support. 


void 


setpragOwnerProxyl DragOwner dragProxy) 
Set a DragOwner "proxy 1 ' for this InfoBean. 


void 


setDropSnabled (boolean enabledrop) 
Set the status of the default Drop support. 


void 


setDropOwnerProxy ( DropOwner drop Proxy) . 
Set a DropOwner "proxy" for this InfoBean. 


void 


sets election (boolean selected) 

Set the selection state of the content object 


void 


setXISNotif ying (boolean notify) 

Set whether the ContentLnfoBean should update based pn XIS events and should notify 
XIS of raw data item attribute changes 



Methods inherited from eiass com.xis.leif.info beans, Data 



_a dd J&F P o pu 1 a t o r . addRaw D ataltemsAsGrou p, a dds er vic e , close, 
creat eB'eanConCextServicesQwnerDelea ator. d ispose , q eJ^Mean_Co. n texCP r o x y , 
qe tBeanCont ex t Service s , qe tSzCorite xt , qetlnfoModel , get J A FPopulators , 
g et Lei f Da ta l temMenu r q e t Le i f D a tal t emMenu , getLei £Da_t a IternMenu , getMenuBar, 

ge_tQ wnedBeanContextChild , qe tService , ge tService . getService . getStatua B ars , get ToolBa rs, 
Q-?_tTJ Is. , ini t ializeBeanC onte xt Reso urces , i n i t i a lizeB e_a_nCont e xtServices , 
inva lidate ! n f oMp d el . .13 Pro p P a s t e En ab 1 ad > IsHandlinaClipboardQperations , 
'^le^5^eAngontextRgaQ,U.rxe^ > j^£aa^^aaj^ptextsejnd-ces , revo)ceAnChoreaPj-^lQ f gPg.QytdlSL£> 
revg k eJlrame P rov ider , r e^ke^jrv ice , s^ej;Dr^JPa^t^En^M.ed/ as. LH ajl^illflC l i pbo a rdOp^ra^ans, , 
valida tePend ingSetBeanContext 



Methods inherited from class com.xis.uLAbstr^ 



a. ddUIBeanListene r. finalize, ge tShor tTitle, getTitle, ge 
iaCl osed , is CloseO K, p_rpce5sUIBeanEvent , r^mg ver^Bjsa^^ ( 
.set Active, 5je££^rj^iilg , setTitle 



isActive, 
rsstoreState. 
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Methods inherited from class javax.swing. JPanel 



qstAccessibleContext . getUTClassID . oaramStrina . updateUI 



Methods inherited from class javax.swing. JComponent 



ad^tAncestorListener , addHotif.x, addPropertyChangeLis tener , addBropert vChaaqeLia tengr . 



- ^ , " j ./ i- w p i. u iQULj clji j LciicL f aaacroDen: vvjnaaqeLis cener > 

addVetoableChanqeLis tener , computaVi s iblaftact . contains , crea teToolTip . disable , enable 
fireFropertyChange , f ireProp artvChanae . f irePropert vChanoe , fireProoe rtyChanae . " '' 
fire P rope rtyChange, f irePropertvChange ■ f irePropert vChanae , f ire Prope rt vChanae , 



■ ' 1 . 1 • ■= — ' - — — — *• - — ^- ^- — r ^- e <■ n - r J. J. J. <S C ^.VJMC i. Y^HQl 

.urePtopertvChangp. f i reVe toablsChanae . ge t Act ionFor Keystroke f qetAct ionMap , 



getAliqnmentX, ge tAlignmentY , getAutoscrolls . qetBorder , getBounds , getClient Prop er u 
getComponentGraphics , ce tCondi cionFor Keystroke , getDebuqGraohicsOptions , getGraphics . 
qetHeiqht , getlnputMap, getlnputMap, get Inout Veri f ier , getlnsets, getlnsets . ' 



getListeners , qetLocation, qetMaximumSize , getMinimumSize , getNext FocusableCoroponen t . 



' ' ■ ' * ^ '- tJ ^'>- faJ >' t '-" . '! . ^ - - t - .. ^ .a > MCL.ii-Liij.mmiuic,e , ^HLIN^XLC QGU5 dDlBLOniDOne Q L 

get;PreferredSize , qetReqisteredfteySt rokes, ggfcRootPane . getSize . ge tToolTioLoca t inn . 

_ — —1 rp i _rrt _ „ j_ l m • n n „4. _ r— • * l „ . . . „ . _ _ . ' _ — ' 



getToolTipText, getToo IT ipTex t , getTopLevelAncestor . aetveri fvlnputWhenFocusTarQat . 
qatVisibleRect , getWidth, getX , qetY . qrabTocus , hasFocus . hide , is DoubleBuf f er ed . 



lsFocusCycleRoot, lsFocusTraversable , i s Light tweightComponent , isManaclngFacus . 
isMaximumSizeSet , isMinimuroSi zeSe t . iaQpaaue . i sOp t imi zedDrawinqEnab 1 ed . isPaint incTi le 
lsPreferredSizeSet , isReguest FocusEnabled , isValida teRoot , paint , paintBorder . 



paintChilriren , paintComponent y paintlrnm edia tely „, paintlmmediately . print . printAll . 
printBorder, printCh ildren , printComponent , processCocnponentKevEvgn t . process Focus Event r 
processKevBinding. processKevEven t . proces sMoaseMot ionSvent . putClien t Property . 
reqisterKeyboardAction. registerKeyboardAction , . remoyeAnces torListener , rerooveNo ti f y . 

" ' ~ removsVe toableChanaeLia tener f 



removePropgrtvChanaeListener . rsmo ve P rope rtvChaaae Listener , 



,, n TT | . , . t- .s. s . ^ .s. r -.^rr*.- - T--^-' *-'->*^ ^ *■ ^ ' J- cin^/v C v C JLC^HQI eilJ. 

repaint, repaint, reQuestDefaultForns . request Fociis . resetKeyboardActions , reshape 
revalidate, scrol IRectToVlsibXe, setActionMao . setAliCTrunentX , setAlignmentY . 
a.etAuto3croll3 f aetSackground, setBorder , set DebugGraphicsQpt ions . setDoubleBuf f ered , ' 



setEnabled , setFont, set For eg round, setlnoutMao , setlnautVerif ier . setMaxi 
setMinimamSize, aetNextFocusableComponent , setOpaque . set Prefer redSize . 

setReguestFocusEnabled. setToolTioText . setOI, setVeri f v InputWhenFocusTarget . setVisibls 



unregisterKeyboardAc^loji, update 



Methods inherited fr o m c 1 ass j ava . a wt.Container 

asld/ add, apld, add, add, addContainer Listener . addlmp l > _co.un t C omp onents , de live r Event . 
doLay^u.t , fjjrdComponejrttAS , findCom ponentAt , getComponent . qe tC omponentAt . g e tCo mponen t_At , 
g-^^rnppjxeivt Gpjint , g eAQ pmp p_n^n t s , getLa yout . insets, inva lidate. IsAncestorQf . lay out" 7' 
,i_ist# list,, locate, minimom Size , paintComponent s . pref e rxedS ize , p rint Componen ts . 
P^^esiSfiatajjiej-^veat, rirojce ss.Eve n t , re move ., remove , remove A 11 , r emove Con ta in e rLis^ener, 
se t L_ayou t , validate., validate Tree 



Methods inherited from class java.awtXomponent 



gSiJLan, add, addCompone n t Li s t ene r . addFoc u sLis tene r, addfiierarchyBoundsLi s_t.e_n.jex. 
^diiiez&rc^tAgter&j:, addlnputMe t'hodLig tener , addKeyLis tener , addMouseLis tener", 
addMQUSgMotionT.iatenar. bounds , cj_e^k_lmage, checklmage, co alesceEvents , c onta ins, 
SXea_te Image, createlm age , disableEvent s , disp atchEvent , e nabl e, enabl e Ev'ents ," 
ana,blj5lnputM,ethods , .get Background, get Bounds . qetColorModel f getComponentQrienta tinn . 
g^Cjjrsor, g etDrop T arget , getFont . ge t F ontM et rics , qe,t For eg round , 
Re_kG_r.ap.hi c_s_C onfi guration , get XnputCon te xt, get lnputMe t h odRe q ues t s , getLocale, 
3efcLo cation , getLocat ionOnScreen , get Name, getParent , getPeer, getSize ", - qetToolkit . 
%3£ZX£&Lqc& i goj^FpjCus., ^andleE;vejnt f imaasLTp_^t:e r i nside / iaDisplayable , is Enabled, 
&a£Aqht w .s lqfti; f is Showi ng, isVali d, JUYJ^sibie, key Down, keyUp, list , list , list , 'lo cation , 
jjQP.t Focus, mouse Down , mous e Drag , tnou seEnter , mouseExit , mouseMove . mou seUp, move . 
ne x_t. Fg _u_a , P^iiltAll, pjja tEvejit:, prep^elmagre, p_.r_epa re Image, proceasCompo nentEvent . 
R^SSa g s jji ejr a rc.h yBo und aEvent , p rocessHi e rar chvEvent , processInputMethodEvent , 
PJ^cessMoja^ remove , remove Comp o nen t L is_t_ener , r emoveFoc us Lis tener t 



.LeaQ^ejjifirar chyBoun dsListener . remove H i e rarchyLijstener f r emove l nputMethodLis t ener , 
r_eta ove Ke y^i s_jten g_r , removeMous eList ener , rjjmgj/eMQ uaeMo t ionLis t e 'ne r . repain t, re paint , 
Ee.Ra.int, .resige, r_esize, set Bounds, se tB_?j_nds , s etC o mponentQr ientat ion , setCurs or . 
s^.t_DropTa r g_e t , 'set Locale, setLo cation, setLocation . setN ame, s etSize , setSize , show, 
SilP_w, size, tcSt ring, trans ferFocua 
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Methods inherited from class i ava.lang. O bject 



clone, eauals, ggtClass, hashCode, notify, notifvAll. wait , wait , wait 



Methods inherited from interface com.xis.ul. ClipboardUser 



iaHQndlinqClipboardOpgiraqAQnSi setHandl inQCliDboardQperar_iQns 



Methods inherited from interface com.xis.ui.JLH.Bean 



ggjgggRftjCfcy&hg Li s,t ener , remqyggrppe r t vChanoa Li s tener 



Field Detail 



RESOURCES 

public static final TypedRe source Bundle RESOURCES 
localized resources for this view object. 



Constructor Detail 



ContentlnfoBean 

public ContentlnfoBean ( ) 

Default constructor that creates an empty ContentlnfoBean. 



Method Detail 



getContents 

public Qbiect gstContanta ( ) 

Fetch the currectly loaded raw data item 
Returns: 

the currently loaded object, or null if no object is loaded 



setXISNotifying 

public void setXISNotifying (boolean notify) 

Set whether the ContentlnfoBean should update based on XIS events and should notify XIS of raw data item 

attribute changes 

Parameters: 

notify - if true then notify XIS, else do not 
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. isXISNotifying 

public boolean i sXISNo tiffing { ) 

Check whether the Con tentlnfo Bean is updating based on XIS events and is notifying X1S of raw data item 

attribute changes 

Returns: 

true if it Is notifying XIS, else false 



remove AliRa>vDataItems 

public void ramovsAllRa-wDataltsma ( ) 

Remove all of the raw data items that are currently loaded 



getResources , 

public TypedRe a our ceBund lie getJEleaouarcea ( ) 

Return the ResourceBundle for this Contentlnf oBean. . 
Overrides: 

q etRa 'soucces In class Datalt e m SinkUIBean 
Returns: 

the statically sourced ResourceBundle. 



infoModelChanged 

public void infoModel Changed ( ) 

Messaged to indicate an InfoModel change for this InfoBean or one or more of its LeifDatal terns. This should 

reload all currently loaded data items to pick up InfoModel changes. "i 

Overrides: 

InfOMQdQlCrianqgd In Class DataltamS inkUIBean 



addRawDataltems 

public void adcLRawD a taltems (Object [ ] rawDatal terns ) 

Add the raw data items in the array. Will only add If the array has only one object and the object is not the 
-currently loaded rawDataltem, . 
Parameters: \ 
raw Data It ems - the array of objects to be added 



addRawDataltem 

public void addRavDatalbam ( Object rawDataltsm) ' 
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Load the raw data item into the ContentlnfoBean. IF the raw data item supports the ContentDomain and has ' 
content of type that is currently supported then it will be displayed. Otherwise, if content creation is set to true then 
default content will be created, using a JAFAndPropertyComponent 
Overrides: 

addRawga_taItera in class l2aiaI£^4jQjfflMSfiffl 
Parameters: 

rawDa ta it em - the raw object to display 



createContent 

protected void createContent ( ) 

Method called when there is no content to display for a raw data item. The default behavior displays a 
JAFAndPropertyComponent of the object, but subclasses may wish to display something else instead. 



isCreatingContent 

public boolean iaCreatingContent ( ) 

Check whether default content creation is set. If so then a JAFAndPropertyComponent will be created for items 

that have no displayable content. 

Returns: 

true if default content is created, else false 



setCreateContent 

* public void setCreateContent (boolean create) 

Set whether content should be created for objects that do not have any displayable content, via a 
JAFAndPropertyComponent. 

Parameters: , 
create - if true, create content, else do not 



removeRawDataltems 

public void removeRawDataltems [Object [ ] rawDat altems ) 

Remove the raw data items In the array. Will only remove the object that is currently loaded if it is contained in the ' 
array 

Parameters: 

r awDatal terns - the array of objects to be removed 



removeRawDataltem 



public void removeRawD a tal tem ( Obj ect cawDataltem) 
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Remove the given raw data item if it is the currently loaded raw data item 
Overrides; 

£tm£5v.afi,^wfi3j;Al£Jai in class Da.taJteinSin^JB.§aji 
Parameters: 

rawDataltem - the object to remove - 



getJAFAndProperty Component 

. public JAFAndFrooertv CogtDonent getJAFAndEropertyCamparient ( ) 

Get the JAFAnd Property component used by the ContentlnfoDcan to display the contents for raw data items that 

have nothing else to display. 

Returns: 

the current JAFAndPropertyComponent being used 



getContainerFo.rContent 

protected Container gstContainorfforContont (int index) 

Get a container with the contents of the content object'at the given index, or null if the content type is not 

supported. Subclass this if you need support for a type that is not already supported. 

Parameters: 

index - the index of in the object 
Returns: 

a Container with the contents at the given index 



getSelectedObjects . 

•public Object M getSelectedObjects ()' 

Get an array of selected objects. This will return an empty array if there are no selected objects. If the raw data 

item is selected it will return an array of size 1 with the raw data item inside • 

Returns: 

an array of selected objects 



.isSelected 

public boolean isSelected () ■ 

Check the selected state of the content object, if there is currently one loaded. If there is none, return false. 
Returns: 

true if there is an object and it is selected 



selectAII 

public void selactAlM) 
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Set the selection state of the object to true. 
Specified by: 

5 elect All in interface ClipboardUser 
Overrides: 



seleefcNone 

public void selectNone ( ) 

Set the selection state of the object to False. 



setSelection. 

public void setSelectian (boolean selected) 



Set the selection state of. the content object 
Parameters: 

the -new selection state 



canCIear 

public boolean canClear() 



Return true if the CDntentlnfoBean has an object and it is selected 
Specified by: 

canCIear in interface ClipboardUser 
Overrides: 

canCIear in class 1 
Returns: 

true if the raw data item is selected 
See Also: 

gfi£3. e.lfecte dgb j seta. (X 



canClear 

public boolean canCIear (Obi ect [ 1 items) 

Return true if the specified items can be cleared. If the item is not in the ContentlnfoBean return false. If there is 
more than one item return false. 
Specified by: 

canCleax in interface CIi.gbo_aKdU.ser 
Overrides: 

canCIear in class DataltemSlnkUlBean 
Parameters: 

items - the Array of items to be cut. 
Returns: 

true if <all of the items are present, otherwise false. 
• See Also; 
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contains (Object [] J 



canCopy 

public boolean canCopy () 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

c anCop y in interface CiJ.pb^aj:dUs.er: • 
Overrides: . 

canCoov in class Data I tsmSinkUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

canClaarU 



canCopy 

public boolean canCopy ( Obi act [ ] items)' 

Return true if the specified items can be copied. If the item is not in'the ContentlnfoBean return false. If there is 
more than one item return false. 
Specified by: 

canCopy in interface ciicboardUser 
Overrides: 

canCopy in class DataltemS lnKUIBean 
Parameters: 

items - the Array of items to be cut. 
Returns: 

true if all of the items are present, otherwise false. 
See Also: 

cariCl -a ar J Object. Q ).. ■ 



canCut 

public boolean canCut ( ) 

■Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

canCut in interface ClipboardUser 
Overrides: 

canCut in class DataltemSlnkUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

canClear ■) 



canCut 

public boolean canCut ( Object [ 1 items) 
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Return true if the specified items can be cut. IF the item is not in the ContentlnfoBean return false. If there is more 
than one item return false, . 
Specified by; 

cancux in interface cUnJpj35ur.cJlis.er 
Overrides: 

canCut in Class Da t a ItemS in kU I Bean 
Parameters: 

items - the Asmy of items to be cut. 
Returns: 



canPaste 

pub Lie boolean canPaste ( ) 

Return true if the ContentlnfoBean can paste new objects, false if not. 
Specified by: 

canPaate in interface ClioboardUaer 
Overrides: 



canSelectAII 

public boolean canSelectAll ( ) 

Return true if the. ContentlnfoBean can select all objects. 
Specified by: 

cans elect All in interface Clipboa rdUse r 
Overrides: 

caryS&lactAll Ln class Da tal temSinkUIBean 
Returns: 



true if all of the items are present, otherwise false. 



See Also: 





Returns: 



default is always true for the ContentlnfoBean. 



returns true if there is an object and it is not selected 



canSelectNone 



public boolean canSelectilone ( ) 



, Return true if the ContentlnfoBean can un-select all objects. 
Returns: 

returns true if the raw data item is selected 



clear 



public void clear 0 
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Notify the ContentlnfoBean to remove the current raw data item only if it is selected. 
Specified by: 

clear in interface ClipboardUser 
Overrides: 

clear in class D a tal temSi nkU I Bea n 



clear 

public void clear ( Obi act f ] items) 

Clears the given items. These items only get cleared if they actually occur in the ContentlnfoBean. 
Specified by: 

.clj2a_r in- interface Cilp_^^£cW3L&.r 
Overrides: 

clear in class Da taltemSlnkUIBean 
Parameters: 

■ items - the items to cleared. 



clearAll 

public void clearAll () 

. Removes the currently loaded object. 



copy 

public void copy ( Clipboard clipboard) 

Called to invoke this ContentlnfoBean's copy action, which- is to copy all selected data to the Clipboard. 
Specified by; 

copy in interface Clipboar dUse r 
Overrides: . 

copy in class Data I temSinkQIBaan 
Parameters: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 



copy 

public void copy (Clipboard clipboard, 
Qbj.ect [ } items) 

Copies the given items into the Clipboard.. 
Specified by: 

copy in interface ClipboardUser 
Overrides: 

copy in class Datalt emS i nkUI Bean 
Parameters: 

clipboard - the Clipboard object that gets posted' to. The actual items posted are contained in a 
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LeifTransferable. 

items - the array of Object items to copied. 



cut 

public void cut (Cl ipboar d clipboard) 

Cut selected items from the ContentlnfDBean and post them into Clipboard, 
Specified by: 

cut in interface ClipboardUser 
Overrides: 

cut: in class Data I tamSi.nkUIBean 
Parameters: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 



cut 

public void cut ( Clipboard clipboard, . 

object £ ] items) • 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard only if they occur in the 
ContentlnfoBean. 
• Specified by: 

cu£ in interface ClipboardUser 
Overrides: 

cut in class Data I temSi nkUIBean 
Parameters: 

clipboard - the Clipboard object that gets posted tn.-The actual items posted are contained in a 
LeifTransferable. 

items - the array of Object items to cut and posted. 



paste 

public void paste (Clipboard clipboard'} 

Paste the data Objects 5orn the given clipboard. This retrieves the clipboard contents and does a simple add. 
Specified by: 

paste in interface ClipboardUser 
Overrides: 

' paste in class D ataltemS inkUIBean 
Parameters: 

clipboard - the Clipboard that contains the objects, 
See Also: 

adtiRawDatial terns (Object ( }± 



contains 

' public final boolean contains ( Object [ I items) 
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Return true if this ContentlnfoBean contains ail the objects of the given array. 
Parameters: 

items - an array of objects to locate in the ContentlnfoBean. 
Returns; 

true if there is only one object and it is contained, false otherwise 



containsComponent 

public boolean containsComponent ( Component component) 

Check if thr given component is contained by this [nfoBean 
Parameters: 

component - the Component to check for 
Returns: 

true if it is contained, else false 



getLeifDataltemMenu' . 

public JMenu qstLeifDatal teroMenu ( Lei f Data Item dataltem, 

boolean shourCutPasteltems) 

Return the data item menu for a LeifDataltem. (usually the selected LeifDataltem). This is used by the menubar to 
add menuitems from this JMenu to a Data menu if there is exactly one DataltemSelected selected. 
Overrides: 

getLeifDataltem Menu in class Datal te inSinkUTBean 
Parameters: 1 

dataltem - the LeifDataltem to get the menu for 

showCut Paste I terns - true to allow cut. and paste items to appear, false to omit them. 
Returns: 

the JMenu for the given LeifDataltem 



isDragEnabled 

public boolean isDragEnaJbled ( ) 

Return true if the default Drag support is enabled. 
Overrides: 

isDragEnabled in class Da t a 1 1 emS ink.gjBg.aj: 
Returns: 

true if drag is enabled, false if not, default is initialized to true. ■ 



setDragEnabled 

.public void setDragEnaJaled (boolean enabledrag) 

Set the status of the default Drag support. 
Overrides: 

setDragEnabled in class DataltemSinkUiBean 
Parameters: 
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enabled rag * true if default drag support should be used, false if not. 



setDragOwnerProxy 

public void setDragOwner Proxy ( DraaOwner dragPrcxy) 

Seta DragOwner "proxy" for this InfoBean. 
Overrides: 

get DragOwner Pcoxv in class Patal temSinkUIBe 
Parameters: 

drag Proxy - a DragOwner implementation, 



isDropEnabled 

public boolean isDropEnablad ( ) 

Return true if the default Drop support is enabled. 
Overrides: . 

ISDroPSnabled In Class DatalbemSinkaiBean 
Returns: 

true if drag is enabled, false if not, default is initialized to true. 



serDrcpEnabled 

public void setDropEixafcled (boolean enabledrop) ■ 

Set the status of 1 the default Drop support. 
Overrides: 

AS t Dro pEnabled in class Da fcalte mSinkUIBean . 
Parameters: 

enabledrop - true if default drag support should be used, false if not. 



s e tD r op OwnerProxy 

public void setDropOwner-Piroxy (DrojiQwner dropProxy) 

Set a DropOwner "proxy" for this InfoBean. 
Overrides: 

s etDrooOwnerPraxy in class D a talc emSinkUEfl ^n 
Parameters: t 

dropProxy - a DropOwner implementation. 



WO 02/46916 



PCT/US01/48418 



66/90 




Package com.xis.Ieif.im 

This package contains classes that provide the APIs for using information management in applications. 
See: 

Description 



Interface Summary 


Attribute 


The Attribute class represents an attribute for a particular data type. 


Attribute A lias 


The At tributeAlias indicates an alias from l..n Attributes to a Single Attribute, together 
with a precision level; the higher the precision, the better the alias. 


Attribute Factory 


The AttrdbuteFactory class allows an implementor to return an appropriate Attribute for 
the given LeifDataltem. 


MrifrtLtkLoakMB. 


The AttributeLookup interface is used to lookup Attribute objects for a particular data 
item. 


PlsptoyjLgbel 


The Display Label Interface defines methods that are needed for use with 
DisplayLabeLAttributes. 


Domain 


This interface describes the basic fields and methods possessed by all Domains. 


Info Mode! 


The infoModel interface is the interface that is used to convert raw data items into 
LeifDataltems. 


LeifDataltem 


The LeifDataltem interface represents a simple data item. 


L^ID^tjiljempM^r^i 


This class is used for observering a LeifDataltem to know when it has finished processing an 
action. 


LiteDataftem 


The LiteDataltem interface represents a data item. 


PropertyPro vider 


If a PropertyProvider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as a default 
command. 


RawDatnltemLookup 


The RawDataltemLookup interface is used to look up a raw data item from a unique id. 



Class Summary 


AbstractAttribute 


The AbstractAttribute class represents an Attribute. 


AttributeAliasPIuggableService 


This register Attribute A liases. 


AttributeDescriptor 


The AttributeDescriptor class is used to describe an 
attribute without providing functionality of how to use the 
attribute. 


AttributeDescriptorFactory 


The AttributeDescriptorFactory class is a singleton 
class used to create or get AttributeDescriptors. 


At tnb uj te£a ctor y I n foModelSubset 


The AttributeFactorylnfoModelSubset class 
provides an InfoModel that will add the Attributes specified 
by the AttributeFactories to all LeifDataltems this 
InfoModel creates. 
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Attrlbjj.tcCetRequest 


The AttributeGetRequast class is used to package all 
the necessary parameters for getting, the value an attribute. 


AttributeLpckRequesJ 


The AttributeLockRaquest class- bundles attributes 
needed to gain access to locked LeifDataltems.- 


Attribu tes 


The Attributes is a container for holding attributes. 


A ttri b u t eS e t R. eq u es.t 


The AttributeSetReques t class is used to package all 
the necessary parameters for setting an attribute. 


Base.DataIk.rn 


The BaseDa.taI tern is the fust wrapper around raw data ' 
items. 


B.aseliTfoMpdej 


//PENDfNG(RX): Any method marked with "PENDFNG" in 
the JavaDoc will //lilcely be removed before XIS is released, 
in final form. 


. BaselnfoModeLServicesProvidcr 


The BaselnfoModelServicesFirovider class will 
provide all the services available from the Basel nfoMode! 
to the given BeanCorttextServices object. 




This class populates JAFMenus for generic collections. 


Data It e mActjo rf M a n a ger 


The DataltemActionManager class provides some useful 
static methods for dealing with actions on LeifDataltems. 


DatalternActionlVlanaoer.LeirReferenceActionListener 


This class is an actionListener to be. used with 
LeifReference "Load" menus. 






The Data I temMenuSet class is used by the 
LeiflAFUtiUties class to return essentially a Dataltern 
popup menu with annotation. 


JQa taljeniMenuSet. Ejijtry. 


The Data I tsmMenuSet .Entry class encapsulates a 
Dataltern and it's menu, and also provides some 
convenience methods for adding additional menu items. 


DefaultWrapperAttribute 


The DefaultWrapperAttribute class is a generic 
attribute that is the superclass of all defaults in generated 
domain attributes. 


DtSDlavLabel Attribute 


The DisplayLabelAttribute diss is used to display 
one or more Attribute values in conjuction with string 
literals specified by users. 


DisiLl_aMLa_bemjiia 


The DisplayLabelData class is used by the 
DisplayLabelAtt ribute to store a mapping of 
LeifDataltems to DisplayLabelTemplates. 


Dh pjayLabelTem p la t e 


The DisplayLabelTemplate class is used by the 
DisplayLabelAttribute to compute and store editing 
and rendering values for every LeifDataltem that has the 
attribute. 


DomainMethod 


Abstractly represents a'Domain Method. 


DomainlVIethnfin^rriptnr 


The DamainMethodDescriptor class is used to describe 
a DomaiiuMethod. 


.Qo !tP a ID M e t h □ d Desc r i p to rFac t o r y 


The DomainMethodDescciptorFactory class is a 
singleton class used to create or get 
DomainMethodDes crip tors. 


DomainWra pper 


This class adds methods to LeifDataltem de legator that are 
useful in the domain wrappers. 


DvnamicAttributes 


The DynamicAttributes class is used for storing ■ 
dynamic attributes. 
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rieIqiWe.taP.ata 


FieldMetaData specifies sorting and subset criteria for an 
attribute. 


Fjel(JJH.eta.Datas 


The FieldMeta'Datas class represents a collection of 
FieldMetaData for a data item. 


InroModelDataltem 


The Inf oModel Dataltem allows views to wrap 
LeifDataltems and add/re move/mod ify attributes that will 
only affect that view. 


InTolVlodelSubset 


Typically when creating an InfoModel to nest within an 
existing InfoModel, which is done by'ViewUlBeans, an 
InfoModelSubset ts used. 


J nv a jjdWrap per A tt rj by t e 


The InvaltdWrapperAttribute class 


LeifDatnUemComparator 


The LeifDataltemCornparator compares LeifDataltems by 
Attribute Descriptor supplied by the user. 


LeifDataitemDelegator 


Implements the methods in LeifDataltem in a wrapper so 
you don't have to. 


LeiroataJtemgorter 


The LeifDatartemSorter provides a default sorting tool for 
all LEIF LeifDataltem objects. 


Lei fD a ta 1 t e m U pd a t e s 


This classes is used with the LeifDataltemObserver, 


Leiflnitialization 


The Leiflnitialization class handles some standard 
initialization for most XIS Applications. 


LeifJAFUtilities 


The Leif JAFUtilities class provides some useful static 
methods for LEIF-related JavaBeans Activation Framework 
(JAF) processing. 


Lei f J AFyMties,,Lej.fB e jfcr FO&cAGliQIlUttfinfiE 


This class is an actionListener to be used with 
LeifReference "Load" menus. 


Lei [Request 


The Leif Request class is used to package all the 
necessary parameters for requesting information for a 
LeifDataltem. 


LeiOLransaction 


The Leif Transaction class is used to construct a 
transaction. 




The LockedLa if Dataltem class is used to enable locking 
on the data item. 


MethodRequest 


The Me thodRe quest class is used to package all the 
necessary parameters for invoking a DomainMethod for a 
LeifDataltem. 


[VlutoMeAJtlci^uteDescripto r 


Mutable subclass of Att t ibuteDescriptor. 


Obsej^erSu pp_ort 


This class provides useful support for using the 
LeifDataltemObserver. 


RequestPooj . 


The RequestPool class is used to assist Object pooling. 


Resources 


The Resources class is automatically generated and must 
be public, but it is intended to be used only by Java's 
internationalization support classes. 


S^ie^XaHe„DataUem 


Creates a wrapper around a LeifDataltem for a 
SelectablelnfoModel. 


Selectable In fotVlodel 


Manages selections for the selectable leif data items that are 
contained within this model. 


XransJaJ_or 


A major design gdal for XIS was to provide the ability to 
integrate existing data item classes without modifying them. 
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Transla.tprR_egistry 


Provides a central location for maintaining Translators, 
extended Translators and locating Domain methods on data 
items. 


Undefined Attribute 


The UndefinedAt tribute class represents an undefined 
attributes. 


V Is ihiii txA t tr.i b y_t e 


The visibilityAttcibute class is an Attribute that is 
ready to use for Lei£DataItem visibility. 



Exception Summary 




The Datal temUo tFoundEx caption class is an exception that can be thrown 
when trying to look up a data item from an id 


l.nv a 1 id O bj ectS ch.ema fj x cept ion 


Signals that there was a problem with the creation or modification of an 
ObjectSchema. 


TranslatorExcepHon 


The TranslatorException class 


UnconvertibleA lias Exception 


Indicates that the requested attribute alias could not be calculated or converted. 


UndeflnedLeirAttributeException 


Indicates that the requested attribute is not applicable for the object. 




The UndefmedLeifMethodException class indicates that the data item does not 
define the method. 


UnremovableAttrihuteExceplion 


The UnremovableAttributeException class indicates an attempt to remove an 
Attribute that was defined by the raw data item (either by reflection or a 
Translator.) Only additional Attributes added 'to LeifDataltems can be removed. 
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com.xis.leif.im 

Interface InfoModel 

All Super-interfaces: 

BeanContextChildOwner . BeanContextChildOwnerDelegator . BeanContextProxy 

All Known Implementing Classes: 
InfoModelSubset 



public interface InfoModel 
extends BeanCpnte^ 

The InfoModel interface is the interface that is used to convert raw data items into LeifDataltems. The InfoModel should 
hold each of these LeifDataltems created using weak references so that the data items can be cleaned up when they are no 
longer being used. //PENDING(RK): Any method marked with "PENDING" in the JavaDoc will likely be removed 
before LEIF is released in final form. 

Since: 

LEIF 4.0 ■ 
Version: 

SRevision: 1.20 S, SDate: 2001/08/17 00:54:54 $ 
Author: 

David Aimilli 



Method Summary 


void 


activateQneOfNService (Obi ect service) 

//PENDrNG(RJC): This method will probably be removed from InfoModel! Notify the InfoModei 
that the given service is the preferred service of its type, and that this particular object should be returned 
if its class is requested, until removed or until another object of the same type is passed to a future call to' 
this method. 


void 


addlnf aModelListerier ( Inf oModelListener listener) 


Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModei. 


void 


addOneOfNService (Ob j ect service) 

//PENDfNG(RK): This method will probably be removed from InfoModel! Add an object as a 
service to be retrieved by a call to getService() (via BeanContext APIs) on any class that this object 
implements or extends. 


void 


clearSelectionO 

Clears the selection. 


u 


dump ( ) 

Gives a list of all the LeifDataltems currently in the InfoModel. 




ggtg zCon text ( ) 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APIs. 
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ge t Le i f D at a I tem ( 1 o n g u i d ) 

1 ilia Will divUUipi IU IVJui^up d LjC ilLJ aid LLC 111 LrUlTi an IU. 




getLeifDataltem {Objject rawDataltem) 

This will wrap a raw Java Object with a LeifDataltem wrapper so you can use it in leif as. a data 

item. 




crefcLeif Da talfcem {Obi ect rawDataltem, boolean create) 

This will wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as a data 
item. , 


[ i 


q-etLeifDataltams (Obi ect f 1 rawData 1 1 ems ) ; * 

This convenience method will wTap an array of raw java Objects, with LeifDataltem wrappers so : 
you can use them in leif as Lei fData Items, 


1 1 . ( Cffttrf %t '. 


gatParentlnf aMpdel { ) • 

Provides access to the parent InfoModel that this InfoModei delegates to. 


Objqcr| ] 


g.etSelectedRawDataltems [ ) 

Gets the list of all the currently selected item 1 ; for this TnfnlVfnrlpI 

wWW LiiW Llhll \J I LliU Will I LI JLI J JUILUIWU lll_illj 1 w I LI i 1 a L 11 L w JL V I LI LI w I 




g.e t Single S e , Les c Jtedl.t^n [ ) 

Get the selected raw data item, if only one. 




getViewHost [ ] 

Gets the ViewHost that this InfoModel is associated with. 


void 


removelnfoModelListener ( Inf oModelListener listener ) 

Removes a listener from this InfoModel so that the listener will no longer be Informed of changes 
to the InfoModel. 


void 


remaveOneOf SSarvice (Obj ect service) 

//PENDFNG(RK): This method will probably be removed from InfoModel! - Remove an object that 
was a service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any .class that this 
object implements or extends. 



Methods inherited from interface com.xis.beans.beancQntext. BeanContextChildOwnerDelegator 

initiali£e,Bean Conte..v.tResources , r a leaseBeanCont ex tRe sources 



Methods inherited from interface com, xis.beans. bean con text.BeanContextCluIdQwner 

3 et 0 [wnedfl ie_an Co n tex tCh i.ld 



Methods inherited from interface java.beans^beancQntext.BeanContext PrQ; 




Method Detail 



getLeifDataltem 

public Le_igp_atalt.em getLeif Dataltem ( long uidj 

throws DataltemNotFoundException 

This will anempt to lookup a LeifDataltem from an id. If the UID is invalid or there isn't a LeifDataltem that 

already exists with that given UID, an exception will be thrown. 

Parameters: 

uid - the unique Id for the raw data item- 
Returns: 
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the LeifDataltem with the given UID 



getLeifDataltem 

public Lei£DaJE3XCeiJi getLeifDataltem (QJ5J, ex t rawDataltem) 

This wilt wrap a raw java Object with a'LeifData-Item wrapper so you can use it in leif as a data item. 
Parameters: 

rawDataltem - the raw data that will be wrapped. (Note: this should not already be a LeifDataltem) 
Returns: 1 
the wrapped data item. 



getLeifDataltem 

public Lej.££a££&£§& getLeifDataltem (Object rawDataltem, 

boolean create) 

This will wrap a raw j'ava Object with a LeifDataltem wrapper so you can use it in leif as a data item. 
Parameters: 

rawDataltem - the raw data that will be wrapped. (Note: this should not already be a LeifDataltem)' 
create - if false and the LeifDataltem is not already in the model, don't create one and return null 
Returns: 

the wrapped data item, or null if M create" is false and not found 



getLeifDataltems ' 

' public Lei f Data I tern M getLeifDataX terns (QJbiect [ ] rawDataltems ) 

This convenience method will wrap an array of raw java Objects with LeifDataltem wrappers so you can use them 
in leif as LeifDataltems. Note that you can get an array of raw data items often from methods like getMembersQ, 
so this is a useful method to have, .' 
Parameters: 

rawDataltems - the raw data objects that will be wrapped. (Note:- the oBjects should not already be 
LeifDataltems) 
Returns: 

the corresponding' wrapped data item array. 



. getEzContext 

public EzContext gstEiContaxt ( ) 

Gets an EZ Context that corresponds to this InfoMode! so the developer can use the EZ APIs. 
Returns: 

the ez context for this info model 



getSingleSelectedltem 

public Obiect getSingleSelectedltem ( ) 
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Get the selected raw data item, if only one. Else return null. 
Returns: 

the. selected item if there is only one. 



getParentlnfoModel 

public InfoModel getParsntlnr* c-Model { ) 

Provides access to the parent InfoModel that this InfoModel delegates to. If there is no parent modei then this will 

return null. 

Returns: 

the parent InfoModel 



clearSelection 

public void clearSelection ( ) 
Clears the selection. 



getSelectedRawDataltems 

public Object [1 getSelectedRawDataltems ( ) 

Gets the list of all the currently .selected items for this InfoModel 
Returns: 

all of the selected data items (as raw data items) 



activateOneOfNService 

public void actd-vateOrxeOrtl Service [ Obje ct service) ' 

//PENDING(RK): This method will probably be removed from InfoModel! Notify the InfoModel that the given 
service is the preferred service of its type, and that this particular object should be returned if its class is requested, 
until removed or until another object of the same type is passed to a future call to this method. 
Parameters: 

service - the object to become the preferred service 



addOneOfNService 

public void addOnaQfNSagvice { Obi ect service) 

//PEN DING (RK): Thisrnethod will probably be removed from InfoModel! Add an object. as a service to be 
retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object implements or extends. 
Parameters: 

service - the object to be returned when requested 
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removeOneOfNService 

public void removBOneOfNSarvice (_Ob ject service) 

//PENDrNG(RJC): This method will probably be removed from InfoModel! Remove an object that was a service to 
be retrieved by a call to getServica() (via BeanContext APIs) on any class that this object implements or extends. 
Parameters: 

service - the object to be removed from service 



getView.Host 

public ViswHost: getViev/Host ( ) 

• Gets the ViewHost that this InfoModel is associated with. If this InfoModel is not associated with a Viewftost then 
this will return null. - 
Returns: 

the view host that is maintaining this InfoModel. 



addlnfoModelListener 

public void addlnfoModelLlstaner ( Inf oM ode IListen er listener) 

Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel. 
Parameters: 

listener - the listener to add 



remcrvelnfoModeJListener 

public void ramovelnf oModelListener ( InfoMode IListener listener) 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes to the 

InfoModel. 

Parameters: 

• listener - the listener- to remove ' 



dump 

public LeifDatatf.Rfnf 1 dump [ ) 

Gives a list of all the LeifDataltems currently in the InfoModel. It is highly recommended to use this method only 
if you absolutely have no other way of accomplishing the task you need to do* Please keep in mind that if you hold 
onto the LeifDataltems contained in the array returned or if you hold onto the array itself, the items will not be 
removed from InfoModel until you release them. If you wish to hold onto them, you should wrap them in 
WeakReference objects. 

Note: When you use the dumpQ method in combination with the addlnfoModelListener so that you can keep track 
of the same set of LeifDataltems as the InfoModel. you can synchronise on the InfoModel to get the dump and 
then add a listener to receive events of future changes. 
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Example: 

synchronized (infoModel) ( 

Leif DataltemC ] dataltems = inf oModel . dump ( ) ; 
infoModel. addlnfoModelListener(this) ; 
for (int i=0; i < data Items . length; i++) [ 
process Item (data Items [i] ) ; 

}• 



Returns: 

the list- of LeifDataltems currently in the InfoModel. 
See Also: 

WeakReference 
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Package com.xisJeif.event 



This package contains classes for handling events in XIS. 
See: 

Description 



Interface Summary 


In foModelListener 


The inf oModelListener is used to monitor changes to an InfoModel. 


LeifDataltemListen er 


This class is used for listening to LeifDataltems for various events. 



Class Summary 


Attrib uteChan aedE vent 


An "AttributeChanged" event gets delivered whenever a data item 
changes an attribute value. 


ContainerAddedEvent 


A "ContainerAdded" event gets delivered whenever a data item is 
contained as a member in a new object. 


ContainerRemovedEvent 


A "ContainerRemoved" event gets delivered whenever a data item has 
been removed as a member from a containing object. 


DataltemReplacedEvent 


The DataltemReplacedEvent class is used to indicate member changes 
of a containing data item. 


InfoModelEvent 


The InfoModelEvent gets delivered whenever a LeifDataltem is created 
by the InfoModel, or when a LeifDataltem has been "lost" by the 
InfoModel. 


InfoModelEventSupport 


The inf oModeiEventSupport support class provides basic support for 
managing listeners on an InfoModel. 


LeifD ataltemAdapter 


The Leaf DataitemAdapter class provides support for setting up a 
LeifDataltemListener on a data item. 


LeifEventSupport 


This, is a utility class for XIS developers to use when they want to fire 
event changes. 


MemberAddedEvent 


The MemberAddedEvent class indicates that members were added to 
this data item. 


MemberEvent 


The MemberEvent class is used to indicate members changes of a 
containing data item. 


MemberRemovedEvent 


The MemberRemovedEvent class indicates that the members are being 
removed from the containing data item. 


ReferenceAddedEvent 


The ReferenceAddedEvent class indicates that LeifReferences were 
added to the LeifDataltem. 


ReferenceEvent 


The ReferenceEvent class indicates changes to the LeifReferences of 
the data item. 
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ReferenceRemovedEvent 


The ReferenceRemovedEvent class indicates that LeifReferences were 
removed from the LeifDataltem. 


ReferrerAddedEvent 


The ReferrerAddedEvent class indicates that a Referrer was added to 
the data item. 


ReferrerRemovedEvent 


The ReferrerRemovedEvent class indicates that a Referrer was 
removed from the data item. 



Package com.xis.leif.event Description 

This package contains classes for handling events in XIS. 



WO 02/46916 



78/90 



PCT/US01/48418 



irtfofiaan 



1 : addRawDalaltern 



; getLeifDataltem 
->[ 



3 : newQ 



J 4 : addLeifDataltemUstenerO 



5 : interrogate (get Attributes, etc) 



Figure 36C 
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Data Source (DSI, etc) 



InfoBean 




tnfoModel 






i — _ — 



LeifDataltem 



1 1 : Data updated 



Individual objects can fire 
propertyCh an ge Events, 
which LEIF Dataltems , 
listen to. • El v 

■ ■ i, , 



2 : property change event 



„ 3 : attributeChanged 
! 



Dataltems can also be - 
changed using the 
LeifDataltem APIs or the 
DomainWrapper APIs* 



4 : attributeChanged 



5 : se(tAttributeO 



Figure 36D 
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Figure 37A 

TestHarness.java 



/* XIS Tutorial standalone sequence example 5 XIS interfacing. */ 

import javax.swing. JFrame; 

import java.awtevent.WindowAdapter; 

import java.awt event. WindowEvent; 

/*{*/ 

import java.awt.GridLayout; 

import java.awt.Toolkit; 

import java.awt.Dimension; 

import java.awt.event.ComponentAdapter; 

import java.awtevent.ComponentEvent; 

import javax.swing JSplitPane; 

import javax.swing.JComponent; 

/*}*/ 

import jclass. chart JCChart; 

import com.xis.Ieif.im.BaselnfoModel; 

import com.xis.plot.PlotlnfoBean; 

import com.xis.plot.chartviews.LeifChartView; 

/*{*/ 

import com.xis.table.TablelnfoBean; 

import com.xis.tree.TreelnfoBean; 
l*yi 

public class TestHarness { , 

public static void main(String[] args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

/*{*/ 

HelloWorld hellol = new HeIloWorld("First HelloWorld object"); 
HelloWorld hello2 = new HelloWorldfSecond HelloWorld object"); 
HelloWorld helloS = new HelloWorld("Third HelloWorld object."); 
HelloWorld hello4 = new HelIoWorld("Fourth HelloWorld object"); 
HelloWorld helloS = new HelloWorld("Fifth HelloWorld object"); 
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Figure 37B 

Continuation of TestHamess.java 

ObjectQ helloArray = new ObjectQ { hellol, hello2, hello3, he!Io4, 
helloS }; 

// create table and plot infobeans to display HelloWorld objects 
TablelnfoBean table = new TablelnfoBeanQ; 

PiotlnfoBean plot = new PlotlnfoBean(); 
plot.setChartType(JCChart.BAR); 

//the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKI NG J3 AR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for further comments. 
plotsetYAxisAttribute( 

"com.xis.domains.movement.MovementDomain.speed"); 
p!otsetDynamicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(true); // needed in some cases for bar chart 



// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrame("HelloWorld(s) Table/Plot"); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSplitPane splitpane = new SaneJSplitPane(table,plot, 
new Dimension(table.getPreferredSize().width + 
pIot.getPreferredSizeQ.width, 
Math. min(table.getPreferredSize(). height, 
plot.getPreferredSize().width)), 

0.50); 

tablePlotFrame.getContentPane().add(splitpane); 
tablePlotFrame. pack(); 
tablePlotFrame.setVisible(true); 

// a tree infobean to display our HelloWorld objects 
TreelnfoBean tree = new TreelnfoBean("HelloWorld(s) Tree"); 
tree.addRawDataltems(helloArray); 

// a top-level frame to hold our tree infobean 

JFrame treeFrame = new JFrame( ,, HelloWorld(s) Tree"); 
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Figure 37C 

Continuation of TestHarness.java 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

if (Toolkit.getDefaultToolkit().getScreenSize().getHeight() > 
cutoffHeight + 200) { 

treeFrame.setLocation(348,cutoffHeight+7); 

} 

7 

// add a listener for window closing 
treeFrame.addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System. exit(0); 

} 

} 

); 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPane().add(tree); 

treeFrame.pack(); 

treeFrame.setVisible(true); 

} // main 



* This class overrides the default JSplitPane to provide a reasonable 

* resize behavior: maintain the left and right panels in the same 

* proportions. 

7 

public static final class SaneJSplitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSplitPane(JComponent leftComponent, 
JComponent rightComponent, 
Dimension dims, double startProportion) { 
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Figure 37D 

Continuation of TestHarness.java 

super(JSplitPane.HORIZONTAL_SPLIT, 

leftComponent, rightComponent); 
setSize(dims); 

// Since the JSplitPane doesn't set the lastDividerLocation 

// variable, nor does it provide any other easier way to maintain 

// the split proportion on resize, we must track the divider 

// location ourself. 

lastWidth = dims.width; 

iastDividerProp = startProportion; 

setDividerLocation(startProportion); 

// this listens for resize events on the spiitpane and makes sure 
// we keep same split proportions 
addComponentListener(new ComponentAdapterQ { 

public void componentResized(ComponentEvent event) { 
setDividerLocation(lastDividerProp); 
lastWidth = (int)event.getComponent(). 
getSize().getWidth(); 

}}); 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isn't foolproof (since 
// resizes can come from other sources) but it works well enough 
leftComponent.addComponentListener(new ComponentAdapterQ { 
public void componentResized(ComponentEvent evqnt) { 
// we add in getDividerSize() / 4 to compensate for a 
// bug in JSplitPane which doesn't take account of the 
// divider width in location-proportion conversions 
IastDividerProp = (double)(getDividerLocation() + 
(getDividerSize() / 4)) / lastWidth; 

}}); 
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Figure 38A 
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Figure 38B 




WO 02/46916 



85/90 



PCT/US01/48418 



He|!oWorld(s)Tree 



FIrstHelloWorld.5ib|eftt _ 
TThird HelloWorld object 
Fourth HelioWortd object 



Name I 



AlicvyProp/PasteiPsn Color Speed (KTS) 



- □ . 



i 












- - 


r first HaloWoffd object 




Properties*, 3 




J ; 1 : : 




j 

1 


J v I , . r . 






• 






- . - : 







Figure 38C 



WO 02/46916 



86/90 



PCT/US01/48418 









Preferred Attributes 




:'!f Property 


v!' 1 ".; .Value 7 


Name 


First HelloWorld object. 


j 1 Speed (KTS) 


_ 1; 


S Pen Color 














| Reset:. -. i' ^ "*• ; / • ~ ? 

t~^. *~ — *^-i'^ :r : :. "••\'»._-.. i v;. ..J 









Figure 38D 



WO 02/46916 



87/90 

FT'o. . 3^ A 



PCT/US01/48418 



com.xis.leif.im 

Interface AttributeAlias 



public interface AttributeAlias 

The AttributeAlias indicates an alias from l..n .Attributes to a single Attribute, together with a 
precision level; the higher the precision, the better the alias. The alias allows a caller to query for one 
of the l..n "from" attributes and get the value stored by the data item under the "to" attribute, possibly 
mediated by some conversion, such as a units transformation. 

If the converted or calcuated value cannot be determined, then the Attribute#getvalue ( ) method 
should throw an UnconvertibieAliasException . This Exception is a subclass of the 
□ndef inedLeifAttributeException which is typically thrown by normal Attributes in this case, 
and it can provide a descriptive message indicating the source of the incompatibility. 

The utility of attribute aliases may be seen by considering the following example: . 

The user has performed a query from an external data source and retrieved a set of Airfields, indexed 
by an ICAO identifier. The user now wants to get the list of Aircraft at one of the airfields. There is a 
local aircraft database with a foreign key field for Airfields, but that key is a WAC identifier, not 
ICAO. 

Assumption: The application was NOT written ahead of time to know about these two databases or 
their ID types. Instead, what you have is an XIS "Leif Da t ait em" for the Airfield, and you have an 
XIS Info Be an for the Aircraft query form. 

What you want to do is to copy (or "drop") the Airfield data item into the "WAC" field in the query', 
form. In doing this, the Form will ask the data item for its "WAC" attribute (because this is all it 
knows about). It uses the "getWAC ( ) " method from some domain (say, the Airf i eld Domain). 

V 

The way this could work is that there would have to be an AttributeAlias defined to convert ICAO 

to WAC - Or, more specifically, AviationDomain.ICAOto Airf ieldDomain. WAC. The 

AttributeAlias returns an Attribute object that knows how to transform ICAOs to WACs (e.g., 
by accessing a conversion table). The Attribute, in turn, has a getvalue ( ) method to execute that 
transformation and return the WAC. 

This process would be entirely transparent to the user, or even the caller, who would just see a result 
returned from the getWAC ( ) method. In cases where the conversion was not possible, the 
UnconvertibieAliasException would.be thrown, possibly providing informative information to 
the caller or user. 

Finally, note that due to the way the mechanism is set up (using resources and a PluqqableService) , 
this AttributeAlias can be installed as a separate module without requiring any re-coding or re- 
compilation of the existing application. 
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Method Sun 


imary 


AttributeDescriptor 

C] 


cretAliasedFrom ( ) 

^ . This indicates which AttributeDescriptors (which in turns means which 
Attributes) are required for the alias. 


AttributeDescriotor 


getAliasedTo () 

This indicates the AttributeDescriptor that this AttributeAlias is for. 


Attribute 


getAt tribute ( ) 

Get the Attribute object that is the alias Attribute. 


int 


getPrecisionPriority ( ) 

This indicates the precision of the AttributeAlias. 



Method Detail 



getPrecisionPriority 

public int getPrecisionPriority ( ) 

This indicates the precision of the AttributeAlias. The higher the number the better the alias. 
This number is used to determine which AttributeAlias to use when there are more than one 
alias for a given Attribute. 
Returns: 

the precision of the alias. 



getAliasedFrom 

public AttributeDescrip tor [ ] getAliasedFrom { } 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. 

Returns: 

the list of descriptors required for this alias. 



getAliasedTo 

public AttributeDescrip tor getAliasedTo ( ) 

This indicates the AttributeDescriptor that this AttributeAlias is for. 
Returns: 

the descriptor that this aliias is for. 
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getAttribute 

public Attribute getAttribute ( ) 

Get the Attribute object that is the alias Attribute. This attribute is responsible for performing 
the translation from the aliased from Attributes. The AttributeDescriptor of the Attribute 
MUST be the same AttributeDescriptor returned by getAliasedTo. 
Returns: 

the attribute that will do the translation. 
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